⚡ Next.js 16 + ValKey/Redis cache + Kubernetes

Next.js web application with 2 pods sharing cache.

[!NOTE] You can also check the other branches for Next.js 14 (main-14), Next.js 15 (main-15) or Redis Strings (redis-strings) as there are variants that may also be useful to you.

💬 About this repo

🐳 Docker

I created the Docker image following the example in:

https://github.com/vercel/next.js/tree/canary/examples/with-docker

I configured the output: "standalone" property in next-config.ts.

More info at:

https://nextjs.org/docs/app/getting-started/deploying#docker

🗃️ Cache

I use ValKey to cache values and ensure consistency across all pods.

I installed custom handler using npm install @mrjasonroy/cache-components-cache-handler:

More info at:

https://github.com/mrjasonroy/cache-components-cache-handler

I added cache-handler.mjs and configured the cacheHandlers property in next.config.ts.

  cacheComponents: true,
  cacheHandlers: {
    default: require.resolve("./cache-handler.mjs"),
    remote: require.resolve("./cache-handler.mjs"),
  },
  cacheMaxMemorySize: 0, // disable default in-memory caching

Additionally, I enabled cacheComponents: true to cache the rendered components.

I followed this example and the same pages to validate the cache using use cache, cacheTag, cacheLife, updateTag and revalidatePath.

[!WARNING] Only Next.js 16 + cacheComponents supports these features.

[!WARNING] CacheHandlers (with S) is different than CacheHandler (without S).

More info at:

https://nextjs.org/docs/app/guides/self-hosting

https://nextjs.org/docs/app/api-reference/config/next-config-js/cacheHandlers

https://nextjs.org/docs/app/api-reference/config/next-config-js/incrementalCacheHandlerPath

🐋 Kubernetes

In the k8s folder, there are all the Kubernetes manifests to create two pods with the Next.js web application and one pod with a Redis server.

🏃 Run

🥇 Option 1

Run in dev mode with npm run dev.

🥈 Option 2

Run in Docker using Docker Compose with docker compose -f "compose.yaml" up -d --build.

🥉 Option 3

Run in Kubernetes:

1. Execute docker build -t nextjs-docker . to create the Docker image.
2. Execute kubectl apply -f k8s/configmaps/nextjs.yaml.
3. Execute kubectl apply -f k8s/deployments/nextjs.yaml.
4. Execute kubectl apply -f k8s/deployments/redis.yaml.
5. Execute kubectl apply -f k8s/services/nextjs.yaml.
6. Execute kubectl apply -f k8s/services/redis.yaml.
7. Access http://localhost:3000.

[!NOTE] You can use this option to deploy your Docker image on your VPS.