Using the latest version?
JFrog Platform User Guide
JFrog Artifactory 6.x Documentation
To get the latest version, go to the JFrog Unified Platform
<VirtualHost *:80> ServerAdmin your@email.address.com DocumentRoot "/srv/www/httpd/htdocs" ServerName artifactory.yourdomain.com ErrorLog "logs/artifactory-error_log" ProxyPreserveHost on AllowEncodedSlashes On ProxyPass /artifactory ajp://<yourdomain>:8019/artifactory </VirtualHost>
Reset Your Cookies
When changing the Artifactory context path in Apache make sure to reset your browser's host and session cookies.
Having a stale context path value cached by cookies can lead to inconsistent issue with the user interface such as Not authorized to instantiate class
errors when switching between tabs.
Configuring Your Tomcat
If you are using a dedicated Tomcat rather than the one that is bundled with the Artifactory download zip file, you must configure the AJP connector located, by default, under $CATALINA_HOME/conf/server.xml
:
<Connector port="8019" protocol="AJP/1.3" maxThreads="500" minSpareThreads="20" enableLookups="false" backlog="100"/>
Please refer to Apache Tomcat Configuration Reference for more configuration options.
Configuring Apache With a Custom Artifactory Path
You can configure Apache using the same setup as above but here the goal is to have http://artifactory.yourdomain.com/repository/
as the root URL for Artifactory as follows:
<VirtualHost *:80> ServerAdmin your@email.address.com DocumentRoot "/srv/www/httpd/htdocs" ServerName artifactory.yourdomain.com ErrorLog "logs/artifactory-error_log" ProxyPreserveHost on AllowEncodedSlashes On ProxyPass /repository ajp://<yourdomain>:8019/artifactory ProxyPassReverse /repository http://artifactory.yourdomain.com/artifactory ProxyPassReverseCookiePath /artifactory /repository </VirtualHost>
Using an HTTP Proxy
When running Artifactory with Tomcat, we recommend that you set up Apache to proxy Artifactory via HTTP.
You must configure redirects correctly using the PassReverse directive, and also set the base URL in Artifactory itself so that the UI links show up correctly.
The sample virtual host assumes that the Tomcat HTTP connector runs on port 8081.
Ensuring HTTP Redirect Works Correctly
For HTTP redirects to work, you must set a PassReverse directive on Apache, otherwise the underlying container base URL is passed in redirects
In the example below it is set to http://artifactory.yourdomain.com/artifactory/
.
<VirtualHost *:80> ServerAdmin your@email.address.com DocumentRoot "/srv/www/httpd/htdocs" ServerName artifactory.yourdomain.com ErrorLog "logs/artifactory-error_log" ProxyPreserveHost on AllowEncodedSlashes On ProxyPass /artifactory http://<yourdomain>:8081/artifactory ProxyPassReverse /artifactory http://artifactory.yourdomain.com/artifactory </VirtualHost>
Setting Up Apache HTTPS
Setting up Apache HTTP server using AJP Protocol
From Artifactory version 6.10, new Artifactory installations will not include the AJP connector in Artifactory’s Tomcat server.xml file (i.e. under $ARTIFACTORY_HOME/tomcat/conf/server.xml).
To use AJP connector, the <Connector port="8019" protocol="AJP/1.3" sendReasonPhrase="true"/> should be added manually to the server.xml file under <Service name="Catalina">.
Upgraded Artifactory environments will be unchanged provided the server.xml file is copied over.
Notice: AJP connector support will be removed in Artifactory's next major version (7.0).
You can set up Apache with SSL (HTTPS) as a front end to Artifactory using either the HTTP or AJP protocol.
Client ----------> HTTPD ----------> Artifactory HTTPS HTTP/AJP
Using AJP
If you are not running Artifactory with Tomcat, then it is recommended to use AJP since it provides the servlet container with all the information about the correct base URL and requires no configuration in Artifactory.
Using an HTTP Proxy
Configuring Apache With mod_proxy_ajp
Installed and Tomcat
The Apache and Tomcat sample configuration is as described in the section on Apache HTTP Server above under Using AJP.
Configuring a Custom URL Base in Artifactory
When using an HTTP proxy, the links produced by Artifactory, as well as certain redirects contain the wrong port and use the http
instead of https
.
Therefore, you must configure a custom base URL as follows:
- On the Admin tab select Configuration | General
Custom URL Base
field
. - Set the Custom URL Base field to the value used to contact Artifactory on Apache
For example:https://artifactory.yourdomain.com/artifactory
Please refer to General Configuration for more details about configuring the base URL.