Skip to content
@Gratonite-Labs

Gratonite Labs

Building Gratonite — a federated, self-hostable, open-source alternative to Discord. One-click deploy, relay-based federation, E2E encryption.

Gratonite Labs

Building Gratonite, a privacy-first, open-source alternative to Discord.

Gratonite is a multi-platform community chat app with real-time messaging, voice/video, guilds, DMs, threads, E2E encryption, federation, moderation, gamification, and self-hosting support. v1.0.0 is live at gratonite.chat.

Built for communities that want more control over their platform.

What Gratonite Is

  • 109 database schemas, 91 API route modules, 51 frontend pages, 77 React components
  • End-to-end encryption for all DMs and group DMs (ECDH P-256 + AES-GCM-256)
  • Instance federation with Ed25519 HTTP Signatures — self-hosted instances can connect and list on Discover
  • One-command Docker deployment with automatic HTTPS via Caddy + Let's Encrypt
  • Full moderation suite, economy system, gamification, voice/video, and creative tools

Repositories

Core

Repository Description
CoodayeA/Gratonite Main monorepo — all source code, Docker images, docs, and deployment config
api Backend API — Express, TypeScript, Socket.IO, PostgreSQL, Redis, LiveKit, federation
web Web client — React, TypeScript, Vite
mobile Mobile client — Expo, React Native
desktop Desktop client — Electron

Infrastructure & Tooling

Repository Description
self-hosted Self-hosting guide and quick-start reference
js-sdk JavaScript SDK and shared TypeScript packages
admin Admin and moderation tooling
gratonite.chat Marketing site
dev-log Development log and architecture notes

Platform-Specific

Repository Description
ios iOS-specific mobile work
android Android-specific mobile work

Self-Hosting

Run your own Gratonite instance in minutes. No coding required — everything runs in pre-built Docker containers.

git clone https://github.com/CoodayeA/Gratonite.git && cd Gratonite
cp deploy/self-host/.env.example deploy/self-host/.env
# Edit .env: set your domain, admin email/password, DB password
docker compose -f deploy/self-host/docker-compose.yml up -d

Docker images: ghcr.io/coodayea/gratonite-api, ghcr.io/coodayea/gratonite-web, ghcr.io/coodayea/gratonite-setup

Full guide: Self-Hosting Guide

Tech Stack

Layer Technology
Frontend React, TypeScript, Vite
Mobile Expo, React Native
Desktop Electron
Backend Node.js, Express, TypeScript
Database PostgreSQL, Drizzle ORM
Cache Redis
Realtime Socket.IO
Voice LiveKit
Auth JWT, Argon2id, TOTP MFA
Federation HTTP Signatures, Ed25519
Search PostgreSQL full-text search
Metrics Prometheus
Deployment Docker Compose, Caddy, GitHub Actions

Links

Support

If you want to support Gratonite:

I'm currently covering hosting, infrastructure, and project costs personally, so any support helps keep the project online and moving.

Popular repositories Loading

  1. api api Public

    Backend API for auth, messaging, guilds, voice, moderation, and realtime features

    TypeScript 2

  2. self-hosted self-hosted Public

    Self-hosted Gratonite deployment using Docker Compose

    Shell 1

  3. web web Public

    Gratonite web client built with React and Vite

    TypeScript

  4. desktop desktop Public

    Gratonite desktop client built with Electron

    JavaScript

  5. ios ios Public

    iOS-focused Gratonite mobile work

    TypeScript

  6. android android Public

    Android-focused Gratonite mobile work

Repositories

Showing 10 of 12 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…