# Global Memcache Configuration

This document describes the configuration options available for the global swift memcache configuration which usually lives under /etc/swift/memcache.conf. Documentation for other swift configuration options can be found at Configuration Documentation.

An example memcache.conf configuration can be found at etc/memcache.conf-sample in the source code repository.

There is only 1 configuration section available:

- [memcache]

## [memcache]

Option | Default | Description
memcache_servers | 127.0.0.1:11211 | Comma separated list of memcached servers ip:port or [ipv6addr]:port
memcache_max_connections | 2 | Max number of connections to each memcached server per worker
connect_timeout | 0.3 | Timeout for connection
pool_timeout | 1.0 | Timeout for pooled connection
tries | 3 | Number of servers to retry on failures getting a pooled connection
io_timeout | 2.0 | Timeout for read and writes
error_suppression_interval | 60.0 | How long without an error before a server’s error count is reset. This will also be how long before a server is reenabled after suppression is triggered. Set to 0 to disable error-limiting.
error_suppression_limit | 10 | How many errors can accumulate before a server is temporarily ignored
item_size_warning_threshold | -1 | If an item size ever gets above item_size_warning_threshold then a warning will be logged. This can be used to alert when memcache item sizes are getting to their limit. It’s an absolute size in bytes. Setting the value to 0 will warn on every memcache set. A value of -1 disables the warning
tls_enabled | False | (Optional) Global toggle for TLS usage when comunicating with the caching servers
tls_cafile |  | (Optional) Path to a file of concatenated CA certificates in PEM format necessary to establish the caching server’s authenticity. If tls_enabled is False, this option is ignored.
tls_certfile |  | (Optional) Path to a single file in PEM format containing the client’s certificate as well as any number of CA certificates needed to establish the certificate’s authenticity. This file is only required when client side authentication is necessary. If tls_enabled is False, this option is ignored
tls_keyfile |  | (Optional) Path to a single file containing the client’s private key in. Otherwhise the private key will be taken from the file specified in tls_certfile. If tls_enabled is False, this option is ignored

this page last updated: 2025-11-03 12:55:44

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug