Köra en server

Den här guiden är för systemadministratörer som installerar och driver en Antimatter-server. Den utgår från att du känner till Linux, Docker och reverse proxies, men inte Antimatter.

Vad en installation består av

Antimatter är ett självhostat chattverktyg för team, en gaff av Mattermost. En komplett installation består av följande delar. Endast de tre första är obligatoriska.

Del	Vad den gör	Obligatorisk
Antimatter-servern	Ett Go-program (`antimatter`) som serverar webbappen, API:et och websockets på port 8065, kör medföljande appar (plugins) och hanterar medier för samtal på port 8443. Kommandoradsverktyget `amctl` hanterar servern.	ja
PostgreSQL	Databasen: meddelanden, användare, communityer och, i den rekommenderade uppsättningen, serverns konfiguration. Version 15 eller nyare.	ja
Lagringsplats för filer	Uppslagna filer, bilder och installerade appar: en S3-kompatibel tjänst (compose-filen kör RustFS) eller en lokal katalog.	ja
En reverse proxy	HTTPS framför servern: compose-filens Caddy-profil eller din egen nginx.	för produktion
GIF-tjänsten (`gifs-server`)	GIF:er och klistermärken för GIF-väljaren, från din egen katalog. Den kommunicerar med Tenor API.	nej
En push-proxy	Vidarebefordrar aviseringar till mobilappen via Apple och Google.	för mobilaviseringar
rtcd, en TURN-server	En separat medieserver för många samtal, och en relay för personer bakom strikta brandväggar.	nej
AI-endpunkter	Modeller som ligger bakom skrivarens omskrivningar, sammanfattningar, översättningar, uppläsning, AI-agenter och transkription av samtal, tillagda som modellanslutningar: en molnleverantör eller servrar som du själv driver.	nej

Antimatter har ingen licens och ingen betald utgåva: enkel inloggning, LDAP, hög tillgänglighet, export för efterlevnad, databevarande och andra funktioner som Mattermost reserverar för sina betalda planer ingår alla.

Krav

En Linux-server, amd64 eller arm64, med 2 CPU-kärnor och 4 GB minne eller mer för några hundra personer, samt diskutrymme för de filer som användarna laddar upp.
Docker Engine med Compose-plugin (docker compose) för den rekommenderade installationen. Eller, för paketen, en Debian-, Ubuntu-, Fedora- eller RHEL-kompatibel server med systemd.
För produktion: ett domännamn som pekar mot servern, och portarna 80 och 443 öppna för HTTPS.
För samtal: port 8443, UDP och TCP, tillgänglig för de som ringer.
För e-post: en SMTP-server som Antimatter kan skicka via.

Snabbstart

mkdir antimatter && cd antimatter
curl -fsSLO https://antimatter.chat/compose.yaml
cat > .env <<EOF
SITE_URL=http://localhost:8065
POSTGRES_PASSWORD=$(openssl rand -hex 24)
S3_SECRET_KEY=$(openssl rand -hex 24)
GIFS_API_KEY=$(openssl rand -hex 24)
AM_AI_ENCRYPTION_KEY=$(openssl rand -base64 32)
EOF
docker compose up -d

Öppna sedan sajtens URL och skapa ditt konto: det första kontot blir systemadministratör. Installation förklarar varje steg samt andra sätt att installera på.

I den här guiden

Installation: Docker Compose, bilderna, den första administratören, .deb- och .rpm-paketen samt releasearkivet.
Konfiguration: inställningar i databasen eller en fil, AM_-miljövariabler, Systemkonsolen, amctl, loggar.
Domän och HTTPS: sajtens URL, Caddy, nginx, klientadresser.
Samtal och röst: portar, NAT, TURN, rtcd, transkription och undertexter.
E-post och push: SMTP, push-proxy och mobilappen.
Medföljande appar: vilka appar som är aktiverade, deras inställningar, installation av andra appar.
AI: modellanslutningar, inbyggda AI-funktioner, agenter, tal och översättning, krypteringsnyckeln och vilken data som går vart.
Inloggning och konton: registrering, lösenord, MFA, single sign-on, LDAP, gäster, sessioner.
Säkerhetskopior och uppgraderingar: säkerhetskopiering, återställning, uppgradering, flytt från Mattermost.
Drift: övervakning, skalning, databevarande, efterlevnad, felsökning.
Säkerhet: checklista för förstärkning och externa anslutningar.
Distribution av skrivbordsappen: MSI, Group Policy och Intune, macOS-profiler och Linux-policyfilen.

Vill du driva en gemenskap snarare än en server (kanaler, roller, moderation)? Se Driva en gemenskap. Bygger du integrationer? Se Bygga på Antimatter.

Din första timme

Installera och skapa administratörskontot direkt.
Placera servern bakom HTTPS på en egen domän.
Konfigurera SMTP och skicka ett testmeddelande.
Öppna porten för samtal. För en arbetsplats, sätt typen av nya samhällen till Arbetsplats så att samtal är aktiverade i kanaler.
Avgör vem som kan registrera sig och aktivera MFA.
Gå igenom de externa anslutningarna i Säkerhet.
Konfigurera dagliga säkerhetskopior. Innan du lägger till AI-modellanslutningar, ställ in AI-krypteringsnyckeln.

Få hjälp

Ställ frågor i community discussions och rapportera fel i community repository. Rapportera säkerhetsproblem privat, enligt säkerhetspolicyn.