Zentra Server

This repo holds the backend server for Zentra, an encrypted community chat application.

Tech Stack

• Go 1.23 - Backend language
• PostgreSQL 16 - Primary database with partitioned tables
• Redis 7 - Session storage, caching, pub/sub
• MinIO - S3-compatible object storage
• Chi Router - HTTP routing
• gorilla/websocket - WebSocket connections

Getting Started

Prerequisites

• Go 1.23+
• Docker & Docker Compose
• Make (optional)

Quick Start

1. Clone the repository

   git clone https://github.com/zentra-chat/server.git
   cd server

2. Set up environment

   cp .env.example .env

3. Start infrastructure

   docker compose up -d postgres redis minio

4. Run migrations

   docker compose run --rm migrate up

5. Start the server

   docker compose up -d --build api

The API will be available at http://localhost:63566 (default API_PORT).

For full API details, see API.md.

To remove containers and volumes:

docker compose down -v

Running migrations

Use the dedicated migration container:

# apply all pending migrations
docker compose run --rm migrate up

# rollback one migration
docker compose run --rm migrate down 1

# rollback three migrations
docker compose run --rm migrate down 3

Run migrations after PostgreSQL is up and before launching API changes that depend on new schema.

Development

# Install dependencies
go mod download

# Run with hot reload (using air)
air