Using Artifactory 5.x ?
JFrog Artifactory 5.x User Guide

Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Artifactory as a Docker Image

Artifactory can be pulled from Bintray as a Docker image and run as a container.To do this, you need to have Docker client properly installed and configured on your machine. For details about installing and using Docker, please refer to the Docker documentation.

If you are running on a Windows or Mac, you can use the Docker native client or to install  boot2docker

Latest Artifactory 4.x version

Please refer to the Release Notes to find the latest 4.x version of Artifactory.


The Artifactory Docker Image comes in three varieties:

Artifactory Pro Registry

The Artifactory Pro Registry image offers all the features of Artifactory activated with a Pro license and is a pre-configured image ready to use as a private Docker registry

How to Download and Install

Artifactory Pro

The Artifactory Pro image offers all the features of Artifactory activated with a Pro license. You may create Docker repositories so Artifactory functions as a private Docker registryHow to Download and Install

Artifactory OSS

The Artifactory OSS image will run in a Docker container and offer all the features of Artifactory OSSHow to Download and Install

For details on how to download, install and use each variety, please refer to its specific documentation page through the corresponding link above.

An example of the Dockerfile that builds each of these images can be found in JFrogDev Artifactory Docker Builder on GitHub.

Pulling Artifactory as a Docker image, running Artifactory as a container and using Artifactory as a private Docker registry is demonstrated in the screencast below.

Configuring Your Database and Filestore

Once you have completed setting up the Artifactory Docker image, make sure you configure its database and filestore according to your preference. For details, please refer to Configuring the Database and Configuring the Filestore.

Upgrading Artifactory

There are two ways to upgrade Artifactory when running with Docker:

  1. An RPM upgrade
  2. Using a Mounted Volume

RPM Upgrade

Artifactory runs from an RPM packge within a Docker container. You can upgrade Artifactory by logging in to your Docker container and following the instructions in Running as an RPM Installation.

Using a Mounted Volume

You can upgrade Artifactory by switching versions while riding on top of your container volumes as follows:

  • Stop your current installation of Artifactory using the following command:
    docker stop <container name>

  • Run the new version of Artifactory using the following command:
    docker run -d --name <new container name> --volumes-from=<container name> -p 8081:8081<oss|pro|registry>:<new version>

  • Once you have established that the new version is running correctly, you can remove the old version as follows:
    docker rm <container name>

    Here is an example showing these three steps when upgrading Artifactory OSS from version 4.0.0 (whose container is called artifactory-4.0.0) to version 4.1.0 (whose container is called artifactory-4.1.0):

    docker stop artifactory-4.0.0
    docker run -d --name artifactory-4.1.0 --volumes-from=artifactory-4.0.0 -p 8081:8081
    docker rm artifactory-4.0.0


  • No labels