Using the latest JFrog products?
JFrog Platform User Guide
JFrog Distribution 1.x Documentation
To get the latest version, go to the JFrog Unified Platform
Docker
JFrog Distribution requires Docker v 1.11 and up to be installed on the machine on which you want to run Distribution. For instructions on installing Docker, please refer to the Docker documentation.
Browsers
Distribution has been tested with the latest versions (known at the time of release) of Google Chrome, Firefox, Internet Explorer, Microsoft Edge and Safari.
Artifactory
JFrog Distribution supports JFrog Artifactory v6.0 and above.
Proxy
In corporate environments it is often required to go through a proxy server to access remote resources.
JFrog Distribution should be installed in the same site as your JFrog Mission Control when communication with Artifactory instances through a proxy is required. This will enable the Distribution service to use the same proxy configurations set up in Mission Control.
Download and Installation
JFrog Distribution may be installed using Docker images, or as a native installation for each of the supported flavors of Linux. Once you have downloaded your preferred installer, follow the installation instructions in the corresponding sections below.
Download
The download links for Enterprise+ installers can be found here
Keep Distribution on your $PATH
Make sure to save the downloaded file in one of the locations defined in your $PATH environment variable so it is accessible from anywhere on your machine.
Supported Installers
- Docker: Distribution is available for download as a Docker image to be run as a container. For for details, please refer to Installing with Docker.
- Linux: Distribution can also be installed as a Linux Archive File Installation.
- Kubernetes: Distribution is also available for installation on Kubernetes. For details, please refer to Installing on Kubernetes.
Using External Databases
JFrog Distribution uses several databases for different features of its operation.
Distribution gives you the option of using your own PostgreSQL database if you have these already installed and in use in your organization.
Supported database versions
Currently, Distribution supports the following external database versions:
PostgreSQL: version 9.6 and above
It is up to you to choose wether to externalize the data base when you install Distribution.
During the installation process, the Distribution installation script will prompt you with questions about whether to install an internal database or to use one already installed in your organization. Simply respond to these prompts as required.
You take full responsibility for your own databases
If you choose to have Distribution use any of your own databases for its operation, you take full responsibility for the maintenance, monitoring, backup and correct functioning of these databases.
For example, the Distribution installation script will ask if you would like to install PostgreSQL.
If you respond with a "Y", Distribution will install PostgreSQL for its own use. If you chose to externalize your PostgreSQL database and choose "n", the Distribution installation script will prompt you for the required connection string.
Would you like to install PostgreSQL instance? [Y/n]: n Type a PostgreSQL connection string [jdbc:postgresql://postgres:5432/distribution?user=distribution&password=password]: jdbc:postgresql://<MACHINE_IP>:5432/distribution?user=distribution&password=password
Accessing Distribution
JFrog Distribution can be accessed using the following URL:
http://<SERVER_NAME>
:8080
For example, if you are accessing Distribution on a machine called "myserver" you would use: http://myserver:8080
Activating Distribution
Once you have completed your Distribution installation, you must continue to the Enterprise Plus Configuration.