Using Artifactory 6.x ?
JFrog Artifactory 6.x User Guide
Still using Artifactory 4.x ?
JFrog Artifactory 4.x User Guide
Have a question? Want to report an issue? Contact JFrog support
You can set up Apache HTTP Server as a front end to Artifactory using either the HTTP or AJP protocol.
The AJP protocol offers optimized low-level binary communication between the servlet container and Apache with additional support for smart-routing and load balancing.
The configuration is flexible and can be used either with
mod_proxy_ajp, or with
The example below shows how to configure Apache using mod_proxy_ajp which is distributed by default, however you need to install and then enable as follows:
The sample virtual host below refers to Apache as a reverse proxy to Tomcat, where Tomcat runs with the AJP connector on port 8019:
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.
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
Please refer to Apache Tomcat Configuration Reference for more configuration options.
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:
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
You can set up Apache with SSL (HTTPS) as a front end to Artifactory using either the HTTP or AJP protocol.
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.
mod_proxy_ajpInstalled and Tomcat
The Apache and Tomcat sample configuration is as described in the section on Apache HTTP Server above under Using AJP.
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
Therefore, you must configure a custom base URL as follows:
Custom URL Base
Please refer to General Configuration for more details about configuring the base URL.