---
title: "Deploy Valkey Bundle"
description: "Deploy and Host Valkey Bundle with Railway"
category: "Storage"
url: https://railway.com/deploy/valkey-bundle-1
---

# Deploy Valkey Bundle

Deploy and Host Valkey Bundle with Railway

**[Deploy Valkey Bundle on Railway](https://railway.com/template/valkey-bundle-1)**

- **Creator:** Valkey
- **Category:** Storage

## Template content

### Valkey Bundle

- **Image:** valkey/bundle
- **Start command:** `/bin/sh -c "exec docker-entrypoint.sh valkey-server --port ${VALKEY_PORT} --requirepass ${VALKEY_PASSWORD} --save 60 1 --loglevel warning --loadmodule /usr/lib/valkey/libjson.so --loadmodule /usr/lib/valkey/libvalkey_bloom.so --loadmodule /usr/lib/valkey/libsearch.so --loadmodule /usr/lib/valkey/libvalkey_ldap.so"`

## Documentation

# Deploy and Host Valkey Bundle with Railway

[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/EEyYqE?referralCode=2VI7d_&utm_medium=integration&utm_source=template&utm_campaign=generic)

One-click deploy of [Valkey Bundle](https://hub.docker.com/r/valkey/valkey-bundle) on Railway with all modules pre-loaded.

Valkey Bundle is a containerized version of Valkey with popular modules including Valkey JSON, Valkey Bloom, Valkey Search, and Valkey LDAP. This template deploys a fully configured Valkey Bundle instance with authentication, persistent storage, and private networking — all with a single click.

## About Hosting Valkey Bundle

Hosting Valkey Bundle involves deploying a high-performance in-memory data structure server that acts as a database, cache, and message broker with all official modules pre-loaded. It runs on port 6379 by default and maintains full Redis API compatibility, so any existing Redis client library works out of the box. This template configures auto-generated authentication, persistent storage via a volume mount at `/data`, and both private networking for service-to-service communication and a TCP proxy for external access. Connection variables are pre-configured and ready to use on deploy.

## Common Use Cases

- Application caching with advanced data structures including native JSON documents and probabilistic filters
- Full-text search and secondary indexing via the Valkey Search module
- Session management with fast in-memory access across distributed systems
- Real-time analytics using counters, streams, sorted sets, and Bloom filters
- LDAP-based authentication for enterprise environments

## Dependencies for Valkey Bundle Hosting

- **Client libraries:** Any Redis-compatible client library (valkey-glide, redis-py, ioredis, Jedis, go-redis, etc.)
- **Memory:** Sufficient RAM allocation for your dataset size and operational overhead

### Deployment Dependencies

- [Valkey Official Documentation](https://valkey.io/docs/)
- [Valkey Bundle on Docker Hub](https://hub.docker.com/r/valkey/valkey-bundle)
- [Valkey Bundle GitHub Repository](https://github.com/valkey-io/valkey-bundle)

## Implementation Details

After deployment, use the `VALKEY_URL` environment variable to connect from your applications:

### Node.js

```javascript
import { GlideClient } from '@valkey/valkey-glide';

const client = await GlideClient.createClient({
  addresses: [{ host: process.env.VALKEY_HOST, port: Number(process.env.VALKEY_PORT) }],
  credentials: { password: process.env.VALKEY_PASSWORD },
});

// JSON module
await client.customCommand(['JSON.SET', 'user:1', '$', '{"name":"Alice"}']);

// Bloom module
await client.customCommand(['BF.ADD', 'emails:seen', 'alice@example.com']);

client.close();
```

### Python

```python
import os
from glide import GlideClient, GlideClientConfiguration, NodeAddress

config = GlideClientConfiguration(
    addresses=[NodeAddress(os.environ["VALKEY_HOST"], int(os.environ["VALKEY_PORT"]))],
    credentials={"password": os.environ["VALKEY_PASSWORD"]},
)
client = await GlideClient.create(config)

await client.set("key", "value")

client.close()
```

## Why Deploy Valkey Bundle on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Valkey Bundle on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Garage S3 Storage](https://railway.com/deploy/garage-s3-storage) — Ultra-light S3 server: fast, open-source, plug-and-play.
- [Redis](https://railway.com/deploy/redis-1) — Self Host Latest Redis with Railway
- [EasyImg](https://railway.com/deploy/easyimg) — Simple self-hostable Nuxt.js personal image hosting system.

Open this page in a browser: https://railway.com/deploy/valkey-bundle-1