Development Environment

A Docker Compose setup with PostgreSQL, Valkey (Redis), and Redpanda (Kafka) including lightweight web UIs for easy management.

Quick Start

./start.sh

See GETTING_STARTED.md for detailed usage instructions and code examples.

Services Included

Databases & Messaging

• PostgreSQL 17 - Relational database (port 5432)
• Valkey 8.0 - Redis-compatible in-memory store (port 6379)
• Redpanda - Kafka-compatible streaming platform (port 19092)

Web UIs

• pgweb - PostgreSQL web interface (http://localhost:15080)
• Redis Commander - Valkey/Redis web interface (http://localhost:15081)
• Redpanda Console - Kafka management UI (http://localhost:15082)

Database Migrations

• dbmate - Database migration tool (see GETTING_STARTED.md for usage)
• Migrations stored in ./migrations directory
• Example migration included in ./migrations/.gitkeep
• Note: We recommend letting your application handle migrations, but dbmate is provided to help you get started

Configuration

Copy .env.example to .env to customize:

cp .env.example .env

Edit .env to change ports, versions, or credentials.

Manual Commands

# Start services
docker compose up -d

# Stop services
docker compose down

# View logs
docker compose logs -f

# View specific service logs
docker compose logs -f postgres

Adding Your Application

Uncomment and customize the myapp service in docker-compose.yml to add your own application with automatic connection to all services.

Data Persistence

All data is stored in Docker named volumes:

• postgres_data - PostgreSQL data
• valkey_data - Valkey data
• redpanda_data - Redpanda data

To remove all data: docker compose down -v

Connection Examples

See the output of ./start.sh for Go and C# connection examples including:

• Database queries
• Key-value operations
• Message publishing/subscribing