# Redis 8 Docker image module loading config directives fail loadmodule redis-stack migration paths

Status: search-observed
Product: Redis
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/redis-8-docker-image-module-loading-config-directives-fail-loadmodule-redis-stack-migration-path
Machine JSON: https://gitdocs.org/api/fixes/redis-8-docker-image-module-loading-config-directives-fail-loadmodule-redis-stack-migration-path.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

The Dockerfile tag may still resolve from caches while the official image is deprecated or no longer maintained; replacement choice is external.

## Fix

```
Verifier checks a maintained replacement, equivalent runtime behavior, and explicit version pinning. Verify required commands/modules and supported patch channel.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- Redis 8 Docker image module loading config directives fail loadmodule redis-stack migration paths
- Redis 8 migration Redis Stack modules loadmodule configuration path
- site:redis.io docs Redis 8 Docker image modules Redis Stack
- Redis Stack Docker loadmodule /opt/redis-stack/lib redisearch.so
- "/opt/redis-stack/lib" "redisearch.so"
- https://redis.io/docs/latest/operate/oss_and_stack/install/install-stack/docker/
- site:redis.io/docs/latest/develop/ai/search-and-query/ Redis 8 Redis Query Engine module built in
- Redis 8 GA Redis Stack capabilities included JSON Search TimeSeries Bloom
- https://redis.io/blog/redis-8-ga/
- https://hub.docker.com/r/redis/redis-stack-server
- https://raw.githubusercontent.com/redis/docker-library-redis/master/8.0/Dockerfile
- github redis docker-library-redis 8.0 Dockerfile loadmodule
- https://hub.docker.com/_/redis
- https://github.com/redis/docker-library-redis/blob/40511fc518c300f3b48059daf43c7ac2ef97550b/debian/Dockerfile
- https://raw.githubusercontent.com/redis/redis/8.0/Makefile
- https://raw.githubusercontent.com/redis/redis/8.0/modules/Makefile
- https://raw.githubusercontent.com/redis/redis/8.0/modules/redisearch/Makefile
- https://raw.githubusercontent.com/redis/redis/8.0/modules/common.mk
- https://raw.githubusercontent.com/redis/docker-library-redis/40511fc518c300f3b48059daf43c7ac2ef97550b/debian/docker-entrypoint.sh

## Sources

- Redis 8 GA and Redis Stack patch retirement: https://redis.io/blog/redis-8-ga/
- Official reference opened by Codex: https://redis.io/docs/latest/operate/oss_and_stack/install/install-stack/docker/
- Official reference opened by Codex: https://redis.io/blog/redis-8-ga/
- Official reference opened by Codex: https://hub.docker.com/r/redis/redis-stack-server
- Official reference opened by Codex: https://raw.githubusercontent.com/redis/docker-library-redis/master/8.0/Dockerfile
- Official reference opened by Codex: https://hub.docker.com/_/redis
- GitHub source file or repository reference: https://github.com/redis/docker-library-redis/blob/40511fc518c300f3b48059daf43c7ac2ef97550b/debian/Dockerfile
- Official reference opened by Codex: https://raw.githubusercontent.com/redis/redis/8.0/Makefile