Skip to end of metadata
Go to start of metadata

Versions: — current

This page is a part of the Getting Started with Repose
series. For more context around pre- and post-actions,
consult the table of contents on that page.



If you are planning on running Repose inside of a servlet container you provide, you will need to install the WAR.  After installation, check out Tomcat Setup or GlassFish Setup for setting up the container.

Debian (apt) based distributions

# update package lists from the server
sudo apt-get update
# install potentially missing packages needed to install Repose
sudo apt-get install -y wget
# add repository
wget -O - | sudo apt-key add -
sudo sh -c 'echo "deb stable main" > /etc/apt/sources.list.d/openrepose.list'
sudo apt-get update
# install Repose
sudo apt-get install -y repose-deb-war repose-filter-bundle repose-extensions-filter-bundle

RHEL (yum) based distributions

# update package lists from the server
sudo yum update -y
# install potentially missing packages needed to install Repose
sudo yum install -y wget
sudo wget
sudo rpm -Uvh rpmforge-release-0.5.3-1.el6.rf.x86_64.rpm
sudo yum install -y daemonize
# add repository
sudo wget -O /etc/yum.repos.d/openrepose.repo
# install Repose
sudo yum install -y repose-war repose-filter-bundle repose-extensions-filter-bundle


If you want to manually download the WAR and dependent JARs, they are available in our Nexus Repository.  This method is not recommended.

The primary artifacts are:


  • No labels


  1. Is there a documentation available on how once can obtain complete repose distribution and launch it with "java -jar <repose jar>" pointing to directory where the config files are.

    I am looking for alternative for deb/rhel installations. Ideally a zip/tar distribution containing all the necessary files.

  2. Maaz Khan

    Repose is not intended to be installed outside of a package management system. That said, you can download all of the artifacts used to produce the Debian and RPM packages from the public Rackspace Nexus Maven repository linked below, but that is not recommended:

    If you are on a *NIX platform, then you can simply download the package managed versions and expand them wherever you would like using the following commands:

    wget &&
    wget &&
    ar -vx repose-valve_8.1.0.0_all.deb &&
    tar -xvzf data.tar.gz &&
    rm -f debian-binary control.tar.gz _gpgorigin data.tar.gz &&
    ar -vx repose-filter-bundle_8.1.0.0_all.deb &&
    tar -xvzf data.tar.gz &&
    rm -f debian-binary control.tar.gz _gpgorigin data.tar.gz &&
    for dir in "/var" "/usr" "/etc" ; do sed -i "s,${dir},$(pwd)${dir}," ./etc/repose/container.cfg.xml ; done &&
    java -jar $(pwd)/usr/share/repose/repose-valve.jar --config-file $(pwd)/etc/repose/ > $(pwd)/var/log/repose/current.log 2>&1

    Since this does not ensure all dependencies are met on the host system and the permissions are not maintained, there are opportunities for this not to work and if it does work the security of the system can not be guaranteed. So for these and the many other possible issues that can arise from not using the packaged version of Repose, we highly recommend not using this for anything but minor testing.

  3. Thanks Bill Scheidegger for the detailed steps.

    Here is what I did to obtain the distribution.

    Install Repose using Deb on ubuntu VM. Based on what I noticed, the two directories after installation that matters are /usr/share/repose (repose binaries) and /etc/repose (xml files). I Zipped both the directories and copied to another Ubuntu VM and unzipped the directories in the same location and it worked. Do you see any problem with this solution?

    I understand that unzipping the binaries too any other location apart from "/usr/share/repose" won't work.


  4. Maaz Khan

    You can unzip it to anywhere. The directory passed in via the --config-file parameter is assumed to have a container.cfg.xml file located in it. That file defines where everything else is expected to be. The documentation for it is here:

    Again the concern here is permissions and missing dependencies as to why we only support the package manager installations.

  5. Thanks for the clarification Bill Scheidegger. One last question:

    So when I use DEB/RHEL package installation it grabs the latest stable version and install it. How do I control this process if I want to install specific version only. 

    What changes are needed in the DEB and RHEL scripts to lets say install Repose and not the latest?

  6. Maaz Khan

    You are correct. By default the package managers install the latest. To override this behavior you have to explicitly state the version. See this for Debian/Ubuntu installs: