This is a transient startup message: Redis restarted and is reading its persistence file back into memory, so it cannot serve commands yet. Waiting and retrying resolves it. Jump to your situation below or work through the methods in order.
By Neeraj Singh ~5 min Updated Jun 2026 89% found this helpful
Error message
LOADING Redis is loading the dataset in memory.
Summary
The LOADING Redis is loading the dataset in memory message is transient and expected: Redis has just restarted and is reading its RDB snapshot or AOF file from disk back into memory before it can serve commands. Until that finishes, most commands are rejected with this message. For a large dataset the load can take a while. The fix is mostly to wait and to make your client resilient: add a retry with exponential backoff so transient LOADING (and similar) responses are retried rather than crashing the app. If loading is unusually slow or never completes, look at the size of the persistence file, disk speed, and whether an oversized AOF could be shrunk with a rewrite. This is not corruption; it is normal warm-up.
What this error means
Redis serves from memory, so when it starts it must first load the dataset from its persistence file, an RDB snapshot or the AOF log, into RAM. While that is happening it is not ready to answer queries, so it returns LOADING for most commands.
That makes this a timing condition, not an error in your data or code. The cure is patience plus a client that expects it: retrying with backoff rides out the warm-up. Persistent slowness points at a large file or slow disk rather than a fault.
Common causes
Redis restarted and is reading its persistence file.
A large RDB or AOF takes time to load.
A replica is loading a snapshot after a failover.
Slow disk I/O extends the load time.
An oversized AOF lengthens startup.
Expert insight
“LOADING is not a problem, it is Redis warming up. It restarted and it is pulling the dataset off disk into memory, and until that is done it will not take commands. The real fix is on the client side, your app should retry with exponential backoff so a brief LOADING does not take it down. If loading drags on, that is a big persistence file or a slow disk, and an AOF rewrite to shrink the file usually helps the next restart.”
Manager, Tech Support & Operations · 19+ years fixing Windows and system errors
✓ How to fix it
Method 1
Wait for loading to finish
1Let Redis finish loading; it serves commands as soon as it is ready.
2Check progress with INFO persistence and the loading field.
3For large datasets this can take a while.
Method 2
Add retry with backoff in the client
1Make the client retry transient errors with exponential backoff.
2Treat LOADING as retryable, not fatal.
3This keeps the app stable across restarts and failovers.
Method 3
Reduce the persistence file size
1Shrink an oversized AOF with a rewrite:
BGREWRITEAOF
2A smaller file loads faster on the next restart.
3Review RDB and AOF settings for your workload.
Method 4
Check disk speed
1Slow disk I/O lengthens loading; confirm the storage is healthy and fast.
2On cloud hosts, check the volume's throughput.
3Faster storage shortens warm-up.
LOADING is normal warm-up after a restart while Redis reads its RDB or AOF into memory. Wait for it to finish, and make your client retry transient errors with exponential backoff so it is not fatal. If loading is slow, shrink the AOF with BGREWRITEAOF and check disk speed.
Frequently asked questions
What does the Redis LOADING error mean?
It means Redis restarted and is reading its persistence file (RDB or AOF) back into memory. Until that finishes it cannot serve most commands, so it returns LOADING. It is transient and expected.
How do I fix it?
Mostly wait, since Redis serves commands as soon as it finishes loading. Make your client retry transient errors with exponential backoff so a brief LOADING does not crash the app.
How long does loading take?
It depends on the dataset size and disk speed. A small dataset loads almost instantly; a large RDB or AOF on slow storage can take from seconds to minutes.
Is my data corrupt?
No. LOADING is normal warm-up, not corruption. Redis is simply reading the dataset into memory before serving traffic, and it becomes available once loading completes.
How do I check loading progress?
Run INFO persistence and look at the loading field and related metrics. It shows whether Redis is still loading and how far along the process is.
Can I make startup faster?
Yes. Shrink an oversized AOF with BGREWRITEAOF so it loads faster next time, and use fast storage. Tuning RDB and AOF settings for your workload also helps.
Still not working?
If Redis stays in LOADING far longer than the dataset size suggests, check the logs for AOF or RDB load errors and confirm the disk is not saturated; a corrupt AOF can be repaired with redis-check-aof. You can also submit your error to us for a tailored fix.