Before you proceed with the installation, review the system requirements.
Additionally, 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.
Installation Steps
Complete the following steps to install the product.
Create your Artifactory home directory and an empty
system.yaml
file. The user creating the folder should be the user running the docker run.Note
The following steps assume that
$JFROG_HOME
environment variable is created in the system. For the correct location of$JFROG_HOME
, see JFrog Product Directory Structure.mkdir -p $JFROG_HOME/artifactory/var/etc/ cd $JFROG_HOME/artifactory/var/etc/ touch ./system.yaml chown -R 1030:1030 $JFROG_HOME/artifactory/var
Run the following command in addition if you are using Docker on a Mac machine.
chmod -R 777 $JFROG_HOME/artifactory/var
Customize the product configuration (optional) including database, Java Opts, and filestore.
Note
For Docker installations, verify that the host's ID
shared.node.id
and IPshared.node.ip
are added to thesystem.yaml
.If these are not manually added, they are automatically resolved as the container's IP, meaning other nodes and services will not be able to reach this instance.
Start the Artifactory container using the process that is relevant for your system.
Artifactory Pro docker run --name artifactory -v $JFROG_HOME/artifactory/var/:/var/opt/jfrog/artifactory -d -p 8081:8081 -p 8082:8082 releases-docker.jfrog.io/jfrog/artifactory-pro:latest Artifactory Open Source docker run --name artifactory -v $JFROG_HOME/artifactory/var/:/var/opt/jfrog/artifactory -d -p 8081:8081 -p 8082:8082 releases-docker.jfrog.io/jfrog/artifactory-oss:latest Artifactory Community Edition for C/C++ docker run --name artifactory -v $JFROG_HOME/artifactory/var/:/var/opt/jfrog/artifactory -d -p 8081:8081 -p 8082:8082 releases-docker.jfrog.io/jfrog/artifactory-cpp-ce:latest
Exposing Multiple Ports
The Docker run command exposes more than one port: 8081 for Artifactory REST APIs and 8082 for all other uses.
Manage Artifactory using native Docker commands.
docker ps docker stop artifactory
Access Artifactory from your browser at:
http://SERVER_HOSTNAME:8082/ui/
. For example, on your local machine:http://localhost:8082/ui/
.Check the Artifactory log.
docker logs -f artifactory
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.Redhat UBI Micro base image
In an effort to provide a more secure Artifactory image, Artifactory now uses the Redhat UBI Micro base image. Some of the tools that were available in the Artifactory image are not available in this more secure image. For more information, see JFrog Products Container Base Image.
Artifactory Post-Installation Steps
Once the installation is complete, complete the following tasks.
Change the default admin password. The default user will have the following credentials predefined in the system:
User: admin, Password: password
Make sure you have applied your licenses
Continue to configure the system using the Artifactory Product Configuration
Configure a reverse proxy (optional for Docker Registry)
You can run Artifactory with one of the supported HTTP serversset up as a front end of each node.