Kjøre en server

Denne veiledningen er for systemadministratorer som installerer og driver en Antimatter-server. Den forutsetter at du kjenner Linux, Docker og reverse proxies, men ikke Antimatter.

Hva en utlevering består av

Antimatter er en selvhostet teamchat, en fork av Mattermost. En komplett utlevering har disse delene. Bare de tre første er obligatoriske.

Del	Hva det gjør	Obligatorisk
Antimatter-serveren	Ét Go-program (`antimatter`) som serverer webapplikasjonen, API-et og websockets på port 8065, kjører de medfølgende appene (plugins) og bærer samtalemedia på port 8443. Kommandolinjeverktøyet `amctl` administrerer det.	ja
PostgreSQL	Databasen: meldinger, brukere, samfunn og, i den anbefalte oppsettet, serverens konfigurasjon. Versjon 15 eller nyere.	ja
Fillokal	Opplastede filer, bilder og installerte apper: en S3-kompatibel tjeneste (compose-filen kjører RustFS), eller en lokal mappe.	ja
En reverse proxy	HTTPS foran serveren: compose-filens Caddy-profil, eller din egen nginx.	for produksjon
GIF-tjenesten (`gifs-server`)	GIF-er og klistermerker for GIF-velgeren, fra ditt eget katalog. Den snakker Tenor API.	nei
En push-proxy	Videresender varsler til mobilappen gjennom Apple og Google.	for mobilvarsler
rtcd, en TURN-server	En separat mediaserver for mange samtaler, og en relay for personer bak strenge brannmurer.	nei
AI-endepunkter	Modellene bak omskriving, oppsummering, oversettelse, opplesing, AI-agenter og transkripsjon av samtaler i komponeringsfeltet, som legges til som modelltilkoblinger: en skytjenesteleverandør eller servere du driver selv.	nei

Antimatter har ingen lisens og ingen betalt utgave: single sign-on, LDAP, høy tilgjengelighet, compliance-eksporter, dataretensjon og de andre funksjonene Mattermost reserverer for sine betalte planer er alle inkludert.

Krav

En Linux-server, amd64 eller arm64, med 2 CPU-kjerner og 4 GB minne eller mer for noen få hundre personer, og plass på disken for filene folk laster opp.
Docker Engine med Compose-tillegget (docker compose) for den anbefalte installasjonen. Eller, for pakkene, en Debian-, Ubuntu-, Fedora- eller RHEL-kompatibel server med systemd.
For produksjon: et domenenavn som peker mot serveren, og portene 80 og 443 åpne for HTTPS.
For samtaler: port 8443, UDP og TCP, tilgjengelig for de som ringer.
For e-post: en SMTP-server Antimatter kan sende gjennom.

Hurtigstart

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

Deretter åpner du nettstedets URL og oppretter kontoen din: den første kontoen blir systemadministratoren. Installasjon forklarer hvert steg og de andre måtene å installere på.

I denne veiledningen

Installasjon: Docker Compose, bildene, den første administratoren, .deb- og .rpm-pakkene og utgavearkivet.
Konfigurasjon: innstillinger i databasen eller en fil, AM_-miljøvariabler, Systemkonsollen, amctl, loggfiler.
Domene og HTTPS: nettstedets URL, Caddy, nginx, klientadresser.
Samtaler og tale: porter, NAT, TURN, rtcd, transkripsjon og live-tekst.
E-post og push: SMTP, push-proxyen og mobilappen.
Medfølgende apper: hvilke apper som er på, innstillingene deres, installasjon av andre.
AI: modelltilkoblinger, innebygde AI-funksjoner, agenter, tale og oversettelse, krypteringsnøkkelen og hvor dataene sendes.
Innlogging og kontoer: registrering, passord, MFA, single sign-on, LDAP, gjester, økter.
Sikkerhetskopier og oppgraderinger: sikkerhetskopiering, gjenoppretting, oppgradering, flytting fra Mattermost.
Drift: overvåking, skalering, databevaring, samsvar, feilsøking.
Sikkerhet: sjekkliste for forsterket sikkerhet og eksterne tilkoblinger.
Utrulling av skrivebordsapp: MSI, Group Policy og Intune, macOS-profiler og Linux-policyfilen.

Vil du drive et samfunn i stedet for en server (kanaler, roller, moderering)? Se Å drive et samfunn. Bygger du integrasjoner? Se Å bygge på Antimatter.

Den første timen

Installer, og opprett administratorkontoen med en gang.
Plasser serveren bak HTTPS på sitt eget domene.
Konfigurer SMTP og send en test-e-post.
Åpne porten for samtaler. For en bedrift, sett typen nye samfunn til Arbeidsplass, slik at samtaler er på i kanaler.
Avgjør hvem som kan registrere seg, og slå på MFA.
Gå gjennom de eksterne tilkoblingene i Sikkerhet.
Sett opp daglige sikkerhetskopier. Før du legger til AI-modelltilkoblinger, må du sette AI-krypteringsnøkkelen.

Få hjelp

Still spørsmål i fellesskapsdiskusjonene, og meld fra om feil i fellesskapsrepositoryet. Meld fra om sikkerhetsproblemer privat, slik sikkerhetspolitikken forklarer.