Installing on Linux Solaris or Mac OS
Skip to end of metadata

    Created by Yoav Landman, last modified by Rami Honig on Apr 12, 2018

Go to start of metadata
Overview

Make sure you have reviewed the overall installation process

Before you proceed with the instructions on this page, make sure you have reviewed the whole installation procedure as described in Installing Artifactory.

This page describes how to install Artifactory on Linux, Solaris or Mac OS.

The procedure for all these platforms is identical, so for the sake of clarity the rest of this page will refer to Linux only.

You can install Artifactory on your Linux system in one of the following ways:

    Manual Installation
    Service Installation

    RPM or Debian Installation

    As a Docker Image

Running as root to install Artifactory as a service or RPM distribution

To install Artifactory as a service or RPM distribution you must have root privileges.

To run as root either execute the following command:

su -

or precede all commands with sudo (e.g. sudo service artifactory start)

If you are unable to get root privileges please contact your system administrator.
Configuring Your Database and Filestore

Once you have completed installing Artifactory, make sure you configure its database and filestore according to your preference. For details, please refer to Configuring the Database and Configuring the Filestore.

Page Contents

    Overview
        Configuring Your Database and Filestore
    Requirements
        Setting JAVA_HOME
        Setting Java Memory Parameters
    Manual Installation
        Installing Artifactory
        Running Artifactory
    Service Installation
        Installing Artifactory
        Running Artifactory
            Using systemd
            Using init.d
            Checking the Artifactory Log
    RPM or Debian Installation
        Managed Files and Folders
        Installing Artifactory
        Running Artifactory
        Backup and Recover
    Running with Docker
    The ARTIFACTORY_HOME Folder
    Accessing Artifactory

Requirements
Setting JAVA_HOME

As mentioned in the section on System Requirements, make sure that your JAVA_HOME environment variable is correctly set to your JDK installation.
Setting Java Memory Parameters

While not a strict requirement, it is recommended to modify the JVM memory parameters used to run Artifactory.

If you can reserve at least 512MB for Artifactory, the recommended values for JVM parameters are:

Recommended minimal JVM parameters

The larger your repository or number of concurrent users, the larger you need to make the -Xms and -Xmx values accordingly. Recommended minimal values are:

-server -Xms512m -Xmx2g -Xss256k -XX:+UseG1GC

For more recommendations about your hardware configuration (especially the -Xmx parameter), please refer to Recommended Hardware.

Where you set your JVM parameters depends on how you are running Artifactory:

    For a manual installation, modify JAVA_OPTIONS in $ARTIFACTORY_HOME/bin/artifactory.default.
    For a service installation, modify JAVA_OPTIONS  in $ARTIFACTORY_HOME/etc/default (you will need to stop and then restart the service after making the modification)
    For an RPM or Debian installation, modify JAVA_OPTIONS in /etc/opt/jfrog/artifactory/default

Manual Installation
Installing Artifactory

To install Artifactory manually, simply unzip the Artifactory download file to a location on your file system. This will be your $ARTIFACTORY_HOME location.

No further action is needed.

Don't forget to modify your JVM parameters as needed by setting JAVA_OPTIONS in $ARTIFACTORY_HOME/bin/artifactory.default.
Running Artifactory

You can run Artifactory manually to see its behavior by directly executing:

$ARTIFACTORY_HOME/bin/artifactory.sh

The console is locked on the Artifactory process and you can stop it cleanly with Ctrl+C.

To directly run Artifactory as a daemon process, using the environment variables of the shell you are currently in, execute the following script:
$ARTIFACTORY_HOME/bin/artifactoryctl start

To verify Artifactory is running, you can access it in your browser at:

http://SERVER_DOMAIN:8081/artifactory

For example, if you are testing on your local machine you would use:  http://localhost:8081/artifactory

Startup time

Depending on your system performance it may take Artifactory several seconds to start up. If you try to access Artifactory through your browser while it is starting up, within a few seconds it will provide a notification that it is in the startup process.

Using the same script, you can check if Artifactory is running and display its process id, or stop it using:
Checking if Artifactory is running or stopping it
$ARTIFACTORY_HOME/bin/artifactoryctl check | stop

 
Service Installation

Artifactory is packaged as a zip file with a bundled Tomcat, and a complete install script that can be used to install it as a service running under a custom user.

Permissions

When running Artifactory as a service, the installation script creates a user called Artifactory which must have run and execute permissions on the installation directory.