The Subdomain Method for Docker

JFrog Artifactory Documentation

JFrog Artifactory
Content Type
User Guide

Getting started with Docker and your self-hosted Artifactory Pro installation using the subdomain method involves four basic steps:

Configure Artifactory

To configure Artifactory and your reverse proxy using the subdomain method, carry out the following steps:

  1. Make sure Artifactory is up and running, and is activated with a valid license.Installing ArtifactoryArtifactory Comparison Matrix

  2. Create your virtual Docker repository (as well as a local and remote Docker repository that it should aggregate). In our example below we will use a repository named docker-virtual.

  3. Make sure you have a reverse proxy server up and running.

  4. Obtain a wildcard SSL certificate or use a wildcard self-signed certificate. To create a self-signed certificate, you can follow these instructions for Ubuntu.


    Make sure your certificate matches the Artifactory hostname used in your reverse proxy configuration. In our example below we will use art.local.

Configure Your Reverse Proxy

Artifactory's can generate your complete reverse proxy configuration file for supported servers.

Go to Reverse Proxy Configuration Generator and fill in the fields according to how your reverse proxy is set up while making sure to:

  1. Use the correct Artifactory hostname in the Public Server Name field of Reverse Proxy Settings (in our example this will be art.local)

  2. Select Subdomain as the Reverse Proxy Method under Docker Reverse Proxy Settings.