Run your own server
What AuraTree is
Section titled “What AuraTree is”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.
The pieces
Section titled “The pieces”- 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.
What you need
Section titled “What you need”- 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 (likelivekit.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.
Where your members’ files live
Section titled “Where your members’ files live”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.
