Mcrouter is a memcached protocol router for scaling memcached deployments.
C++ Python C M4 Ragel Shell Makefile
mjkelly and facebook-github-bot OSS: Update automake URL CentOS 7 build script (#234)
This is a manual diff for the following pull request:

Original description:
The previous URL 404s. Additionally, check if automake is already installed before trying to install it again. This means the build script doesn't abort if run a second time.
Fixes #230
cc khfayzullaev
Closes #234

Reviewed By: andreazevedo

Differential Revision: D8768973

Pulled By: orishu

fbshipit-source-id: a9a18e54838d0b75d30ba8a58e6cb50808c340f0
Latest commit 00ab708 Jul 10, 2018

Mcrouter Build Status

Mcrouter is a memcached protocol router for scaling memcached ( deployments. It's a core component of cache infrastructure at Facebook and Instagram where mcrouter handles almost 5 billion requests per second at peak.

Mcrouter is developed and maintained by Facebook.

See to get started.

Quick start guide

New! Ubuntu package available

Currently, we only have Ubuntu Xenial (16.04) amd64 package. Here is how to install it:

Add the repo key:

$ wget -O - | sudo apt-key add

Add the following line to apt sources file /etc/apt/sources.list

deb xenial contrib

Update the local repo cache:

$ sudo apt-get update

Install mcrouter:

$ sudo apt-get install mcrouter

Installing From Source

See for more detailed installation instructions.

Mcrouter depends on folly (

The installation is a standard autotools flow:

$ autoreconf --install
$ ./configure
$ make
$ sudo make install
$ mcrouter --help

Assuming you have a memcached instance on the local host running on port 5001, the simplest mcrouter setup is:

$ mcrouter \
                  "route":"PoolRoute|A"}' \
    -p 5000
$ echo -ne "get key\r\n" | nc 0 5000

(nc is the GNU Netcat,


  • Memcached ASCII protocol
  • Connection pooling
  • Multiple hashing schemes
  • Prefix routing
  • Replicated pools
  • Production traffic shadowing
  • Online reconfiguration
  • Flexible routing
  • Destination health monitoring/automatic failover
  • Cold cache warm up
  • Broadcast operations
  • Reliable delete stream
  • Multi-cluster support
  • Rich stats and debug commands
  • Quality of service
  • Large values
  • Multi-level caches
  • IPv6 support
  • SSL support


Documentation: Engineering discussions and support:


Copyright (c) 2016, Facebook, Inc.

Licensed under the MIT license: