Kørsel af en server

Denne guide er til systemadministratorer, der installerer og driver en Antimatter-server. Den forudsætter, at du kender Linux, Docker og reverse proxies, men ikke Antimatter.

Hvad en deployment består af

Antimatter er en selvhostet team-chat, en fork af Mattermost. En komplet deployment har følgende dele. Kun de første tre er obligatoriske.

Del	Hvad den gør	Obligatorisk
Antimatter-serveren	Ét Go-program (`antimatter`), der serverer webappen, API’et og websockets på port 8065, kører de medfølgende apps (plugins) og håndterer medie for opkald på port 8443. Kommandolinjeværktøjet `amctl` administrerer det.	ja
PostgreSQL	Databasen: beskeder, brugere, fællesskaber og, i den anbefalede opsætning, serverens konfiguration. Version 15 eller nyere.	ja
Fildeling	Uploadede filer, billeder og installerede apps: en S3-kompatibel tjeneste (compose-filen kører RustFS) eller et lokalt katalog.	ja
En reverse proxy	HTTPS foran serveren: compose-filens Caddy-profil eller din egen nginx.	til produktion
GIF-tjenesten (`gifs-server`)	GIF’er og stickers til GIF-vælgeren, fra dit eget katalog. Den taler Tenor API.	nej
En push-proxy	Videresender notifikationer til mobilappen via Apple og Google.	til mobilnotifikationer
rtcd, en TURN-server	En separat medieserver til mange opkald og en relay for personer bag strenge firewalls.	nej
AI-endpoints	Modellerne bag kompositorens omskrivning, opsummering, oversættelse, oplæsning, AI-agenter og transkription af opkald, tilføjet som modelforbindelser: en cloududbyder eller servere, du driver.	nej

Antimatter har ingen licens og ingen betalt udgave: single sign-on, LDAP, høj tilgængelighed, compliance-eksport, dataretention og de andre funktioner, Mattermost forbeholder for sine betalte planer, er alle inkluderet.

Krav

En Linux-server, amd64 eller arm64, med 2 CPU-kerner og 4 GB hukommelse eller mere til et par hundrede personer, samt plads på disken til de filer, folk uploader.
Docker Engine med Compose-plugin (docker compose) til den anbefalede installation. Eller, for pakkerne, en Debian-, Ubuntu-, Fedora- eller RHEL-kompatibel server med systemd.
Til produktion: et domænenavn, der peger på serveren, og porte 80 og 443 åbne for HTTPS.
Til opkald: port 8443, UDP og TCP, tilgængelig for dem, der ringer.
Til e-mail: en SMTP-server, Antimatter kan sende gennem.

Hurtig start

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

Åbn derefter webstedets URL og opret din konto: den første konto bliver systemadministrator. Installation forklarer hvert skridt og de andre måder at installere på.

I denne guide

Installation: Docker Compose, billederne, den første administrator, .deb- og .rpm-pakkerne samt udgivelsesarkivet.
Konfiguration: indstillinger i databasen eller en fil, AM_-miljøvariabler, Systemkonsol, amctl, logfiler.
Domæne og HTTPS: webstedets URL, Caddy, nginx, klientadresser.
Opkald og lyd: porte, NAT, TURN, rtcd, transkription og undertitler.
E-mail og push: SMTP, push-proxyen og mobilappen.
Indbyggede apps: hvilke apps der er aktiveret, deres indstillinger, installation af andre.
AI: modelforbindelser, de indbyggede AI-funktioner, agenter, tale og oversættelse, krypteringsnøglen og hvilke data der sendes hvorhen.
Login og konti: registrering, adgangskoder, MFA, single sign-on, LDAP, gæster, sessioner.
Sikkerhedskopier og opgraderinger: sikkerhedskopi, gendannelse, opgradering, flytning fra Mattermost.
Drift: overvågning, skalering, dataretention, compliance, fejlfinding.
Sikkerhed: tjekliste til forstærket sikkerhed og eksterne forbindelser.
Udrulning af desktop-appen: MSI, Group Policy og Intune, macOS-profiler og Linux-policyfilen.

Driver du en fællesskab i stedet for en server (kanaler, roller, moderation)? Se Drift af et fællesskab. Bygger du integrationer? Se Bygning på Antimatter.

Din første time

Installer, og opret administratorkontoen med det samme.
Sæt serveren bag HTTPS på sit eget domæne.
Konfigurér SMTP og send en test-e-mail.
Åbn opkaldsporten. For en virksomhed skal du angive typen af nye fællesskaber til Arbejdsområde, så opkald er aktiveret i kanaler.
Afgør, hvem der kan registrere sig, og slå MFA til.
Gennemgå de eksterne forbindelser i Sikkerhed.
Indstil daglige sikkerhedskopier. Før du tilføjer AI-modelforbindelser, skal du sætte AI-krypteringsnøglen.

Hjælp

Stil spørgsmål i community discussions og rapportér fejl i community repository. Rapportér sikkerhedsproblemer privat, som sikkerhedspolitikken forklarer.