Skip to end of metadata
Go to start of metadata
Table of Contents
Expand all   Collapse all

Generic Instructions

"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 webapps folder.

Deploy the 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 artifactory-x.y.x.zip distribution.

It is recommended not to include any version characters in the name of the war file, and leave it as: artifactory.war, to prevent having version-specific information in the Artifactory base URL and to simplify future upgrades.

The $ARTIFACTORY_HOME Folder

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 ${user.home}/.artifactory.

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.

Ensure the folder is writable by the user running the Servlet Container.

Manual Deployment

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:

  1. 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 $ARTIFACTORY_HOME/etc/artifactory.config.xml file).
  2. 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.
  • No labels