Skip to content
A tomcat session manager that backups sessions in memcached and pulls them from there if asked for unknown sessions
Java Ruby
Pull request Compare This branch is 3 commits ahead, 215 commits behind magro:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


memcached-session-manager is a tomcat session manager that keeps sessions in memcached, for highly available, scalable and fault tolerant web applications. It supports both sticky and non-sticky configurations, and is currently working with tomcat 6.x and 7.x. For sticky sessions session failover (tomcat crash) is supported, for non-sticky sessions this is the default (a session is served by default by different tomcats for different requests). Also memcashed failover (memcached crash) is supported via migration of sessions. There shall also be no single point of failure, so when a memcached fails the session will not be lost (but either be available in tomcat or in another memcached).

The project home page is located at

Installation and Configuration

Basically you must put the spymemcached jar and the memcached-session-manager jar into tomcat's lib folder. Additionally you must set the Manager class and add some configuration attributes. This is described in detail in the SetupAndConfiguration wiki page.

Where to get help

Checkout the wiki for documentation, contact the mailing list or submit an issue.

How to contribute

If you want to contribute to this project you can fork the sources on github, make your changes and submit a pull request. Alternatively you can submit an issue with a patch attached. Or you start on the mailing list and we'll see how we can work together.


There's a github project that has various memcached-session-manager example configurations, both sticky and non-sticky, with tomcat 6 and tomcat7, with wicket or openwebbeans and more. Just checkout the different branches and see if there's interesting for you.

Something went wrong with that request. Please try again.