"Drop the War": Zero Configuration
Artifactory can be installed under any Servlet container by simply dropping or installing the
artifactory.war file into the containers web applications folder, for example, into Tomcat's
All you have to do is deploy the
artifactory.war file into your Servlet container, either by hot-deploy or by following the container's standard web application deployment procedures.
It is recommended to remove the version name from the war file, leaving it just as:
The Artifactory Home Folder
Even with zero configuration, it is important to know where the Artifactory home folder is, since this folder stores your configurations and important repository data.
When Artifactory runs for the first time, it will set up a default configuration and create all needed files and folders under a
$ARTIFACTORY_HOME folder that, if unset, will default to
If you wish to control the location of
$ARTIFACTORY_HOME (which you probably do when installing Artifactory on a production server), you can do one of the following:
- Startup the Servlet Container VM with
-Dartifactory.home=$ARTIFACTORY_HOME, pointing to the location of your Artifactory home folder, or
- Set an
$ARTIFACTORY_HOMEenvironment variable pointing to this location.
Artifactory will try to create the folder on startup if it does not already exist.
Make sure the folder is writable by the user running the Servlet Container.
You can set up Artifactory on any Servlet container by deploying the war and pointing Artifactory to a dedicated
ARTIFACTORY_HOME created by extracting the Artifactory distribution zip. To do this:
- Extract the Artifactory distribution archive (artifactory-xxx.zip) to a dedicated folder. This folder will be you
ARTIFACTORY_HOME(verify this by checking the presence of the
- Start the Servlet Container and specify the location of
ARTIFACTORY_HOMEby either using a JVM argument or by using an environment variable as explained in the previous section.