Before you proceed, see System Requirements for information on supported platforms, supported browsers, and other requirements.
In addition, review the Docker requirements.
Docker Requirements
For Docker and Docker Compose installations, JFrog services require Docker 20.10.10 and above, and Docker Compose v1.24 and above to be installed on the machine on which you want to run on.
For install instructions, refer to the Docker and the Docker Compose documentation.
Complete the following steps to install the product.
Extract the contents of the compressed archive and go to the extracted folder.
tar -xvf jfrog-distribution-<version>-compose.tar.gz
.env file included within the Docker-Compose archive
The .env file is used by docker-compose and is updated during installations and upgrades.
Some operating systems do not display dot files by default. If you make any changes to the file, remember to backup before an upgrade.
Create the following folder structure under
JFROG_HOME
.`-- [1020 1020 ] var |-- [1020 1020 ] data | |-- [999 999 ] postgres | | `-- [999 999 ] data | `-- [999 999 ] redis |-- [1020 1020 ] etc
Copy the appropriate docker-compose templates from the templates folder to the extracted folder. Rename it as
docker-compose.yaml
.Requirement
Template
Distribution with externalised databases
docker-compose.yaml
Distribution with PostgreSQL
docker-compose-postgres.yaml
Docker for Mac
When you use Docker Compose in Mac,
/etc/localtime
might not work as expected since it might not be a shared location in the docker-for-mac settings.You can remove the following line from the selected
docker-compose.yaml
file to avoid installation issues.- /etc/localtime:/etc/localtime:ro
Update the
.env
file.You can enter the installation directory for Distribution. The default value is
$HOME/.jfrog/distribution
ROOT_DATA_DIR=
Customize the product configuration.
Set the Artifactory connection details.
Customize the PostgreSQL Database connection details. (optional)
Set any additional configurations (for example: ports, node id) using the Distribution
system.yaml
file.Note
Ensure the host's ID and IP are added to the
system.yaml
. This is important to ensure that other products and Platform deployments can reach this instance.
Start Distribution using docker-compose commands.
docker-compose -p distribution logs docker-compose -p distribution ps docker-compose -p distribution up -d docker-compose -p distribution down
Access Artifactory from your browser at:
http://SERVER_HOSTNAME/ui/
.For example, on your local machine:
http://localhost/ui/
.Check the Distribution log.
docker-compose -p distribution logs
Configure log rotation of the console log
The
console.log
file can grow quickly since all services write to it. For more information, see configure the log rotation.