Need help with other JFrog products?
Using the latest JFrog Artifactory version? See the documentation here.
The onboarding wizard makes sure you get Artifactory set up with the minimal information needed to get started.
Welcome: The beginning of the onboarding wizard. Click Next to get started.
|License: Enter your license key and click Next to continue.||Admin password: Set the admin password (recommended) and click Next to continue, or click Skip to stay with the default admin password.|
Proxy: Configure a proxy server and click Next to continue, or click Skip to configure one later.
Create Repositories: Select the package formats for which Artifactory should create default repositories and click Create to continue.
|Summary: Displays the default repositories created according to your selection. Click Finish to complete the wizard and get started with Artifactory.|
Artifactory Bootstrap YAML File
Setting up Artifactory using the YAML configuration file is a convenient alternative to going through the startup wizard. In addition, it gives you an easy way to save the basic configuration of one instance and then quickly and easily reproduce that configuration in other instances you set up.
When using the YAML configuration file, you don't have to configure all the parameters described in the Overview above. You may configure only some of the parameters using the YAML file, and then configure the others through the start up wizard, or manually later on after Artifactory has started up.
These limitations stem from the principle that the YAML configuration file is designated for configuration of new Artifactory instances that essentially, have not been used before. When bootstrapping a new instance of Artifactory, it will load the configuration specified in this file if all of the following conditions are met:
- No repositories have been created
- A proxy has not been set up, or a proxy has been set up and you did not configure proxy setup through the YAML configuration file
- The base URL has not been set up, or the base URL has been set up and you did not configure the base URL through the YAML configuration file
- Artifactory has not been activated with a license, or it has been activated with a license and you did not configure the license through the YAML configuration file
Location and Usage
The YAML configuration file template can be found under
$ARTIFACTORY_HOME/misc/artifactory.config.template.yml. To specify your initial bootstrap configuration, uncomment the relevant sections in the file and provide the configuration details. Rename the file, save it as
artifactory.config.import.yml and place it under Artifactory's etc folder. When done you should have the following configuration file:
An example of the YAML configuration file template used for Artifactory 5.0 can be found below:
For example, to set your base URL to be "https://acme.artifactory.com", you should uncomment the baseUrl section and, while keeping the same indentation, set:
Indentation is significant in YAML. Make sure to maintain the same indentation levels when editing the YAML configuration file.
Exporting a Configuration
When Artifactory is bootstrapped for the first time, it stores a copy of its initial configuration under
$ARTIFACTORY_HOME/etc/artifactory.config.<timestamp>.yml regardless of whether it was bootstrapped using the Onboarding Wizard, or using a YAML configuration file. To use this configuration to bootstrap additional Artifactory instances, copy the file into the new instance's
$ARTIFACTORY_HOME/etc folder and rename it to artifactory.config.import.yml.
Accessing Artifactory Using Single Sign-On (SSO)
When you log in to Artifactory, the following screen opens. Use your Authentication Provider Artifactory login credentials to log in to Artifactory. Contact your admin if you do not know your credentials.