Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Overview

This section provides a guide on the different ways you can install and configure Artifactory.

Installing Artifactory HA

There are different instructions for installing Artifactory HA

If you are installing an Artifactory HA cluster, please refer to HA Installation and Setup. If you following the instructions on this page for an installation of Artifactory HA, your HA cluster will not work.

System Requirements

Before you install Artifactory please refer to System Requirements for information on supported platforms, supported browsers and other requirements.

Installation

The installation procedure involves the following main steps:

  1. Installing Artifactory
  2. Configuring the database
  3. Configuring the filestore
  4. Configuring an HTTP Server (Optional)

Installing Artifactory

For detailed instructions, visit one of the following platform-specific pages:

Configuring the Database

Artifactory comes with an embedded Derby Database out-of-the-box which it is pre-configured to use, however, for better performance and to reuse existing infrastructures you may have, you can configure Artifactory to work with alternative supported databases.

For details please refer to Configuring the Database.

Configuring the Filestore

By default, Artifactory is configured to use the local file system as its filestore. Artifactory supports a variety of additional filestore configurations to meet a variety of needs for binary storage providers, storage size and redundancy. For details, please refer to Configuring the Filestore.

Configuring an HTTP Server

You can run Artifactory with one of the supported HTTP servers set up as a front end. For details please refer to Configuring a Reverse Proxy.


Directory Structure

After installing Artifactory, the $ARTIFACTORY_HOME directory will contain the following directory structure (the $ARTIFACTORY_HOME directory location depends on your installation type):

File/Folder
Description

logs

Artifactory log files (general, access, request etc.)
etcConfiguration files
etc/pluginsCustom Groovy user plugins.
etc/securityGlobal security related files (configuring global encryption key, PGP signing key etc.).
etc/uiManually uploaded custom UI logos.

data/derby

The Derby database (only present when using Derby).

data/filestore

The checksum based storage of binaries when using the default filesystem storage.

data/tmp/work

Directory to save temporary files which Artifactory generates.

data/tmp/artifactory-uploads

Directory to save files uploaded using the Web UI.
binArtifactory startup/shutdown scripts.

tomcat

The default tomcat directory bundled with Artifactory.
tomcat/workThe tmp directory tomcat and the JVM uses (Tomcat automatically assigns it to a java system environment variable as java.io.tmpdir)
tomcat/logsAdditional Tomcat log files
miscConfiguration files used as examples for different databases and servlet containers.

backup

The default backup directory Artifactory uses for system wide and repository backup. 
webappsContains the Artifactory WAR file used by the bundled tomcat distribution.

Default Admin User

Once installation is complete, Artifactory has a default user with admin privileges predefined in the system:

User: admin

Password: password

Change the admin password

We strongly recommend changing the admin password as soon as installation is complete.