Self-Hosting Gratonite

Run your own instance in 5 minutes. No programming required.

Quick Start

# Clone and start

git clone https://github.com/CoodayeA/Gratonite.git

cd Gratonite/deploy/self-host

cp .env.example .env

docker compose up -d

# Open https://your-domain.com/setup

What You Need

  • ✓

    A Server

    Any Linux machine, VPS, or even your home PC

  • ✓

    Docker

    Docker and Docker Compose installed

  • ✓

    A Domain

    Or use Cloudflare Tunnel for zero-config hosting

Features

Federation

Connect with other Gratonite servers

Relay Network

Works behind NAT — no port forwarding

Voice & Video

Optional LiveKit integration

E2E Encryption

Messages encrypted between instances

Setup Wizard

Beautiful UI for first-time config

Auto-Updates

Pull latest image and restart

Home Hosting

Want to run Gratonite from your home computer? No problem. Use Cloudflare Tunnel for zero-port-forwarding hosting:

# Add tunnel token to .env

CLOUDFLARE_TUNNEL_TOKEN=your-token

# Start with tunnel

docker compose --profile tunnel up -d

Full Documentation

For complete configuration reference, troubleshooting, and advanced setup, see the full docs in the repository.

View Full Docs →