Versions Compared

Old Version 10

changes.mady.by.user Yoav Landman

Saved on

compared with

New Version Current

changes.mady.by.user Yoav Landman

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

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

Tip

It is recommended to remove the version name from the war file, leaving it just as: artifactory.war, in order not to have version-specific information as part of the Artifactory URLs.

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

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_HOME environment variable pointing to this location.

Artifactory will try to create the folder on startup if it does not already exist.

Note

Make sure 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 and pointing Artifactory to a dedicated ARTIFACTORY_HOME created by extracting the Artifactory distribution zip. To do this:

  1. 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 $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.