--- updatedAt: 2026-06-07T14:05:02.000Z agentTools: siteIndex: https://docs.jfrog.com/llms.txt projectIndex: https://docs.jfrog.com/installation/llms.txt --- # Artifactory Docker Upgrade Upgrade Artifactory with Docker or Docker Compose for containerized, dependency-simplified deployments. Upgrading Artifactory using Docker provides a reliable, containerized approach to managing your instance. This method simplifies the upgrade process and its dependencies. Choose your environment below to get started: * [Upgrade Artifactory using Docker Compose](#upgrade-artifactory-using-docker-compose) * [Upgrade Artifactory using Docker](#upgrade-artifactory-using-docker) ## Upgrade Artifactory using Docker Compose This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via Docker Compose to a newer 7.x version. If you want to upgrade from any version lower than 7.x, see [Upgrading Artifactory from 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x). #### Preparation and Pre-Upgrade Checks To ensure a smooth upgrade, consider the following: * **Backup Your Data:** We **strongly recommend** performing a full backup of your Artifactory data directory (`$JFROG_HOME/artifactory/var`) and database before starting the upgrade. This allows recovery in case of unexpected issues. * **Review Release Notes:** Always check the [Artifactory Release Notes](/releases/docs/artifactory-release-notes) for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here. * **Downtime:** In a single-node setup, the Artifactory service is unavailable to users during the upgrade. In High Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, so the service remains available. #### Upgrade Steps 1. **Stop the current containers:** ```bash docker-compose -p rt down ``` 2. **Download and extract the new archive:** Download the new archive, then extract its contents and navigate to the folder. ```bash tar -xvf jfrog-artifactory---compose.tar.gz cd artifactory-- ``` 3. **Copy the .env file and run the config script:** Copy the contents of the original `.env` file (except for the version field) into the newly extracted `.env` file. Then, run the `config.sh` script to set up folders with the required ownership. ```bash ./config.sh ``` 4. **Start the Artifactory services:** Start PostgreSQL first, if applicable, then start the main Artifactory services. ```bash # Starting from Artifactory 7.8.x, PostgreSQL needs to be started before starting the other services. # if PostgreSQL 9.6.11 running docker-compose -p rt-postgres -f docker-compose-postgres-9-6.11v.yaml up -d # if PostgreSQL 10.13 running docker-compose -p rt-postgres -f docker-compose-postgres-10-13v.yaml up -d # if PostgreSQL 12.3 running docker-compose -p rt-postgres -f docker-compose-postgres.yaml up -d # Start Artifactory docker-compose -p rt up -d ``` 5. **Verify the Upgrade:** * **Access UI:** Access `http://:8082/ui/` in your browser to verify the UI loads. * **Monitor Logs:** Use this command to check for any startup errors. ```bash tail -f $ROOT_DATA_DIR/var/log/console.log ``` #### Troubleshooting and Post-Upgrade Notes * **Database Migrations:** During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema. ## Upgrade Artifactory using Docker This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via Docker to a newer 7.x version. If you want to upgrade from any version lower than 7.x, see [Upgrading Artifactory from 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x). #### Preparation and Pre-Upgrade Checks To ensure a smooth upgrade, consider the following: * **Backup Your Data:** We **strongly recommend** performing a full backup of your Artifactory data directory (`$JFROG_HOME/artifactory/var`) and database before starting the upgrade. This allows recovery in case of unexpected issues. * **Review Release Notes:** Always check the [Artifactory Release Notes](/releases/docs/artifactory-release-notes) for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here. * **Downtime:** In a single-node setup, the Artifactory service is unavailable to users during the upgrade. In High Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, so the service remains available. #### Upgrade Steps 1. **Stop and remove the existing container:** ```bash docker stop artifactory docker rm -f artifactory ``` 2. **Set the path to your current Artifactory home and permissions:** Set the path to your existing Artifactory data directory and ensure the permissions are correct. ```bash export ARTIFACTORY_HOME= chown -R 1030:1030 $ARTIFACTORY_HOME ``` 3. **Start the new Artifactory container:** ```bash docker run --name artifactory -v $ARTIFACTORY_HOME:/var/opt/jfrog/artifactory -d -p 8081:8081 -p 8082:8082 releases-docker.jfrog.io/jfrog/artifactory-: ``` 4. **Verify the Upgrade:** * **Access UI:** Access `http://:8082/ui/` in your browser to verify the UI loads. * **Monitor Logs:** Use this command to check for any startup errors. ```bash docker logs -f artifactory ``` #### Troubleshooting and Post-Upgrade Notes * **Database Migrations:** During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema. ## Related Topics * [Artifactory Upgrade](upgrading-artifactory) * [Products Upgrade](upgrade) * [Artifactory Helm Upgrade](upgrade-helm-charts) * [Artifactory Linux Package Upgrade](upgrade-linux-package) * [Artifactory Upgrade from Version 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x) * [System Requirements](system-requirements)