redis.conf Validator

Paste a redis.conf to see how Redis will actually read it. The file format has three details that a quick glance misses: values can be quoted, some directives accumulate rather than replace, and a duplicated scalar silently keeps only the last one.

Paste below, or drop a file anywhere on this panel

Or drop a file anywhere on this panel. Nothing is uploaded: the analysis runs in this tab.

The answer appears here

Paste on the left and press Validate. Nothing leaves this tab.

Examples

Real input you can load into the tool above. Each one shows a different thing going wrong, because that is what the tool is for.

Set twice

Redis silently uses the last one, so the edit above it does nothing

maxmemory 1gb
appendonly yes
maxmemory 2gb

An invalid policy

A value that stops the server starting, named exactly

maxmemory 1gb
maxmemory-policy allkeys-mru

Common mistakes

These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.

  1. Editing a directive that appears twice in the file

    Redis uses the last occurrence and ignores earlier ones silently. An edit made above another copy has no effect and looks like Redis ignored it.

    Instead:Search the whole file for the directive before changing it.

  2. Splitting config lines on whitespace when reading them

    Values can be quoted. `save ""` disables snapshotting entirely, and a naive split reads it as something else.

    Instead:Respect the quoting, which is the same splitter Redis uses for inline commands.

  3. Putting an include at the top and expecting it to win

    Includes are processed positionally, so a file included at the top is overridden by everything below it, and one at the end overrides everything above.

    Instead:Place the include according to which side you want to win, and say so in a comment.

Three things about the file format that are not obvious

redis.conf looks like a flat list of settings. It is close to that, and the places where it is not are where configurations quietly do something other than what they read as.

The last occurrence wins, with no warning

Set maxmemory twice and Redis uses the second one. It does not complain, it does not log anything, and the first line stays in the file looking authoritative. This is the usual explanation for an edit that appears to have been ignored: it was made above another copy of the same directive.

Some directives are meant to repeat

save takes one line per snapshot schedule, and client-output-buffer-limit one per client class. For these, repetition is the syntax rather than an override, so a tool that treats the file as a simple key-value map reports the wrong persistence policy. save "" on its own line disables snapshotting entirely, which only reads correctly if the quoting was understood.

Quoting is real

Redis parses config lines with the same splitter it uses for inline commands, so double quotes allow spaces and backslash escapes, and single quotes allow spaces without escapes. An unbalanced quote is a startup failure rather than a warning, and there is no partial load: the server refuses to start at all.

include is positional

An include is processed where it appears, so a file included at the END overrides everything above it, and one at the top is overridden by everything below. Most people assume the opposite. Anything in an included file is invisible to this page.

What this cannot see

This carries a curated list of directives rather than a guessed complete one, so a directive it does not recognise is reported as unrecognised rather than as invalid. It also cannot see command line overrides, which beat the file, or anything set at runtime with CONFIG SET, which beats both until a restart.

More redis tools

Redis Hash Slot Calculator Which of the 16,384 slots does this key land in? Redis Hash Tag Tester Will these keys survive a multi-key command? Redis RESP Protocol Decoder Read what the server actually sent Redis RESP2 vs RESP3 Reply Decoder What the same reply looks like on each protocol Redis Command to RESP Exactly what your client puts on the socket Redis Glob Pattern Tester Redis globs are not shell globs Redis Connection URL Parser The path is the database number Redis Memory Unit Converter 1g and 1gb are not the same number Redis TTL Converter -1 and -2 are not durations Redis Stream ID Parser The first half is a millisecond timestamp Redis Production Config Linter The settings that cause incidents redis.conf to CONFIG SET Which of these can you change without a restart? Redis ACL Rule Decoder What does this user actually get? Redis ACL Validator Find the rule that does nothing Redis INFO Analyzer The numbers INFO does not print Redis SLOWLOG Analyzer What blocked everyone else Redis CLUSTER NODES Parser Read the topology, and find the gap Redis Cluster Slot Distribution Who owns how much, and what is missing Redis Keyspace Notification Flags Why your events never arrive Redis Memory Calculator The encoding decides, not the data Redis Key Count to Memory The fixed cost per key Redis Encoding Threshold Calculator One field more, several times the memory Redis Bitmap Memory Calculator Sized by the highest bit, not the set ones Redis HyperLogLog Calculator 12 KB whether you count a thousand or a billion Redis Cluster Sizing Only 60% of each node is usable Redis RDB and AOF Size Calculator The fork needs memory, not disk Redis Replication Bandwidth Calculator How long the backlog actually covers Redis Connection Pool Calculator More connections is not more throughput Redis Pipeline Calculator It removes round trips, not work Redis Cache Hit Rate Calculator 99% to 90% is ten times the backend load Redis Eviction Policy Simulator volatile- with no TTLs is noeviction Redis Cost Estimator Your rates, so nothing goes stale Redis Config File Generator A redis.conf with the reasons in it Redis ACL Generator A user that can do exactly one job Redis Maxmemory Config Generator The limit, and the headroom it needs Redis Persistence Config Generator How much you can afford to lose Redis Lua Script Generator Atomic, and short enough to stay that way Redis TLS Config Generator Encrypted, and the old port actually closed Redis Sentinel Config Generator Failover that can actually be authorised Redis Cluster Config Generator Three primaries, and the bus port open Redis Docker Compose Generator Local Redis that is not on the internet Redis Client Config Generator Timeouts on both sides, and a sane pool Redis MEMORY STATS Analyzer Which number actually matters Redis Bigkeys Output Analyzer Elements are not bytes Redis CLIENT LIST Analyzer Find the connection hurting you Redis LATENCY Report Analyzer An empty report may mean nothing was recorded Redis Keyspace Prefix Analyzer Which key family is growing Redis SET Command Builder A plain SET clears the TTL Redis ZRANGE Query Builder REV reverses the argument order Redis SCAN Iteration Planner COUNT is a hint, not a page size Redis Key Name Validator Legal is not the same as workable Redis Cluster Compatibility Checker Works now, breaks when you shard

Elsewhere on the site