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 3

  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
  • android Public

    Android-focused Gratonite mobile work

    Gratonite-Labs/android's past year of commit activity
    0 0 0 0 Updated Mar 10, 2026
  • ios Public

    iOS-focused Gratonite mobile work

    Gratonite-Labs/ios's past year of commit activity
    TypeScript 0 0 0 0 Updated Mar 10, 2026
  • dev-log Public

    Development log, architecture notes, and project status for Gratonite

    Gratonite-Labs/dev-log's past year of commit activity
    0 0 0 0 Updated Mar 10, 2026
  • gratonite.chat Public

    Marketing site and public-facing content for gratonite.chat

    Gratonite-Labs/gratonite.chat's past year of commit activity
    0 0 0 0 Updated Mar 10, 2026
  • admin Public

    Admin tooling and moderation workflows for Gratonite

    Gratonite-Labs/admin's past year of commit activity
    0 0 0 0 Updated Mar 10, 2026
  • js-sdk Public

    JavaScript SDK and shared TypeScript packages for Gratonite

    Gratonite-Labs/js-sdk's past year of commit activity
    TypeScript 0 0 0 0 Updated Mar 10, 2026
  • mobile Public

    Gratonite mobile client built with Expo and React Native

    Gratonite-Labs/mobile's past year of commit activity
    TypeScript 0 0 0 0 Updated Mar 9, 2026
  • desktop Public

    Gratonite desktop client built with Electron

    Gratonite-Labs/desktop's past year of commit activity
    JavaScript 0 0 0 0 Updated Mar 9, 2026
  • web Public

    Gratonite web client built with React and Vite

    Gratonite-Labs/web's past year of commit activity
    TypeScript 0 0 0 0 Updated Mar 9, 2026
  • api Public

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

    Gratonite-Labs/api's past year of commit activity
    TypeScript 3 0 0 0 Updated Mar 9, 2026

People

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