"Drop the War": Zero Configuration
Artifactory can be installed under any Servlet container by simply dropping or installing the
artifactory.war file into the container's web applications folder, for example, into Tomcat's
artifactory.war file into your Servlet container, either by hot-deploy or by following the container's standard web application deployment procedures.
NOTE! that the
artifactory.war file is located under the
webapps folder in the
Even with zero configuration, it is important to know where the Artifactory home folder is located, since this folder stores your configurations and important repository data.
When Artifactory runs for the first time, it sets up a default configuration and creates all necessary files and folders under a
$ARTIFACTORY_HOME folder that, if unset, defaults to
To control the location of
$ARTIFACTORY_HOME (particularly when installing Artifactory on a production server), either:
- Start the Servlet Container VM with
-Dartifactory.home=$ARTIFACTORY_HOME, pointing to the location of your Artifactory home folder
- or -
- Set an
$ARTIFACTORY_HOME environment variable pointing to this location.
Artifactory creates the folder on startup if it does not already exist.
You can set up Artifactory on any Servlet container by deploying the war file and directing Artifactory to a dedicated
ARTIFACTORY_HOME created by extracting the Artifactory distribution zip.
To manually deploy the war file:
- Extract the Artifactory distribution archive (artifactory-xxx.zip) to a dedicated folder
This folder is
ARTIFACTORY_HOME (verify this by checking the presence of the
- Start the Servlet Container and specify the location of
ARTIFACTORY_HOME by either using a JVM argument or by using an environment variable as explained in the previous section.