Skip to end of metadata
Go to start of metadata

Versions: —
(Links to:, latest


What is Repose?

Repose is an open-source, RESTful, middleware platform that transparently integrates with your existing infrastructure.  See What is Repose? for more details.

Environment Setup

Installation instructions are provided for Debian package managers (e.g., APT) and RPM package managers (e.g., Yum).

Certain deployment methods will handle environment setup automatically. For more information, see: Deployment


While Repose can be installed manually, other deployment options are provided to make getting started with Repose easier. See: Deployment

Repose can be run as a standalone application using Valve (run either as a Linux service or directly from the JAR) or inside of a servlet container (e.g. Tomcat, GlassFish) using the WAR.

Proxy Server (Valve)

This is the most common setup and is detailed on the Valve Installation page.

Starting Repose

After installing it this way, consult the Running Valve page for details on starting and stopping Repose.

Servlet Container WAR

Instructions for installing the WAR are on the WAR Installation page.

Tomcat Setup

After installing the WAR, there is additional setup to get everything working with Tomcat.  See Tomcat Setup for more details.

GlassFish Setup

See GlassFish Setup for more details.


Once you know how you'll want to configure Repose, you may want to automate the deployment using a configuration management tool or reusable container.


If you don't already have a Linux environment ready, you can use Vagrant to easily create a new virtual machine running the Linux distribution of your choice. For more details, see: Vagrant


Docker and Repose make a fantastic team together. For more details, see: Docker


There is an unsupported starter module in the GitHub repository rackerlabs/puppet-repose.


There is an unsupported starter cookbook in the GitHub repository rackerlabs/cookbook-repose.


If you're ready to dive into configuration, see Configuration for more details..  We also have a series of Tutorials that will walk you through some of our common use cases.

Performance Tuning

Repose has been battle tested in production environments and in our performance testing environments.  See Performance Best Practices for more details.



For further information on common configuration scenarios, visit our Tutorials page.


For details on common troubleshooting techniques, visit our Troubleshooting page.


For a list of frequently asked questions and answers, visit our FAQs page.

Contact Us

There are a variety of ways to reach us.  See Contact Us for more details.

  • No labels