Skip to content

Run your own server

AuraTree is the self-hosted core of a community: messaging, voice and video, server management, events, storage and distributed voice. It runs as a set of Docker services, built on Fastify, Socket.IO, PostgreSQL, Valkey (the cache), LiveKit (voice) and ntfy (push), with your files in S3-compatible storage.

  • AuraTree: your server. Required.
  • AuraBranch: optional relays for people far from your server.
  • AuraCanopy: links your server with others. Built in, nothing extra to install.
  • A VPS, or a machine at home with a public IPv4 address. It must be amd64 (x86-64): ARM machines won’t run it.
  • Docker with Compose 2.24.4 or newer.
  • Two DNS names pointing at the machine: one for chat (like chat.example.com) and one for voice (like livekit.example.com). A third (files.example.com) only if you use the bundled MinIO.
  • An SMTP account for email. Members verify their address.
  • S3-compatible storage (Cloudflare R2, Backblaze B2, Wasabi, AWS S3 or similar), unless you use the bundled MinIO.

Pictures, sounds, encrypted DM file parts and file lockers are kept in the storage you choose. Pick a provider and region you’re comfortable keeping your members’ files in.

  • Hosted storage (recommended, and the default). Files sit with that provider, in the region you pick.
  • Bundled MinIO (optional). Files stay on your machine. Its image is frozen at the last free release and gets no security updates.

Next: Deploy AuraTree.