Een server draaien

Deze gids is bedoeld voor systeembeheerders die een Antimatter-server installeren en draaien. Er wordt van u verondersteld dat u bekend bent met Linux, Docker en reverse proxies, maar niet met Antimatter.

Waar een implementatie uit bestaat

Antimatter is een zelfgehoste teamchat, een fork van Mattermost. Een volledige implementatie bestaat uit de volgende onderdelen. Alleen de eerste drie zijn verplicht.

Onderdeel	Wat het doet	Verplicht
De Antimatter-server	Eén Go-programma (`antimatter`) dat de webapp, de API en de websockets op poort 8065 aanbiedt, de ingebouwde apps (plugins) uitvoert en de mediastroom voor gesprekken op poort 8443 verwerkt. Het command-line-gereedschap `amctl` beheert de server.	ja
PostgreSQL	De database: berichten, gebruikers, gemeenschappen en, in de aanbevolen configuratie, de instellingen van de server. Versie 15 of nieuwer.	ja
Bestandsopslag	Geüploade bestanden, afbeeldingen en geïnstalleerde apps: een S3-compatibele service (het compose-bestand gebruikt RustFS) of een lokale map.	ja
Een reverse proxy	HTTPS vóór de server: het Caddy-profiel in het compose-bestand, of uw eigen nginx.	voor productie
De GIF-service (`gifs-server`)	GIF's en stickers voor de GIF-keuzer, uit uw eigen catalogus. De service communiceert via de Tenor API.	nee
Een push-proxy	Verstuurt meldingen naar de mobiele app via Apple en Google.	voor mobiele meldingen
rtcd, een TURN-server	Een aparte mediaserver voor veel gesprekken, en een relay voor mensen achter strikte firewalls.	nee
AI-eindpunten	De modellen achter het herschrijven en samenvatten van de composer, vertalingen, voorlezen, AI-agents en transcriptie van gesprekken, toegevoegd als modelverbindingen: een cloudprovider of servers die u zelf draait.	nee

Antimatter heeft geen licentie en geen betaalde editie: single sign-on, LDAP, hoge beschikbaarheid, compliance-exports, dataretentie en andere functies die Mattermost voorbehoudt aan betaalde abonnementen, zijn allemaal inbegrepen.

Vereisten

Een Linux-server, amd64 of arm64, met 2 CPU-kernen en 4 GB geheugen of meer voor enkele honderden gebruikers, en schijfruimte voor de bestanden die gebruikers uploaden.
Docker Engine met de Compose-plugin (docker compose), voor de aanbevolen installatie. Of, voor de pakketten, een Debian-, Ubuntu-, Fedora- of RHEL-compatibele server met systemd.
Voor productie: een domeinnaam die naar de server wijst, en poorten 80 en 443 open voor HTTPS.
Voor gesprekken: poort 8443, UDP en TCP, bereikbaar voor de mensen die bellen.
Voor e-mail: een SMTP-server waar Antimatter doorheen kan versturen.

Snelstart

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

Open de site-URL en maak uw account aan: het eerste account wordt de systeembeheerder. Installeren legt elke stap en de andere installatiemethodes uit.

In deze gids

Installeren: Docker Compose, de images, de eerste beheerder, de .deb- en .rpm-pakketten en het releasearchief.
Configuratie: instellingen in de database of een bestand, AM_omgevingsvariabelen, de Systeemconsole, amctl, logs.
Domein en HTTPS: de site-URL, Caddy, nginx, clientadressen.
Gesprekken en spraak: poorten, NAT, TURN, rtcd, transcriptie en ondertiteling.
E-mail en push: SMTP, de push-proxy en de mobiele app.
Inbegrepen apps: welke apps zijn ingeschakeld, hun instellingen, het installeren van andere apps.
AI: modelverbindingen, de ingebouwde AI-functies, agents, spraak en vertaling, de versleutelingsleutel en welke gegevens waar naartoe gaan.
Aanmelden en accounts: registratie, wachtwoorden, MFA, single sign-on, LDAP, gasten, sessies.
Backups en upgrades: back-up, herstel, upgrade, verhuizen van Mattermost.
Bewerkingen: monitoring, schalen, gegevensretentie, compliance, probleemoplossing.
Beveiliging: versterkingschecklist en externe verbindingen.
Uitrolen van de desktopapp: de MSI, Group Policy en Intune, macOS-profielen en het Linux-beleidbestand.

U wilt een community runnen in plaats van een server (kanalen, rollen, moderatie)? Zie Een community runnen. U wilt integraties bouwen? Zie Bouwen op Antimatter.

Uw eerste uur

Installeer en maak direct het beheerdersaccount aan.
Plaats de server achter HTTPS op een eigen domein.
Configureer SMTP en verstuur een test-e-mail.
Open de poort voor gesprekken. Stel voor een bedrijf het type nieuwe gemeenschappen in op Werkplek, zodat gesprekken in kanalen zijn ingeschakeld.
Bepaal wie zich kan registreren en schakel MFA in.
Controleer de externe verbindingen in Beveiliging.
Stel dagelijkse back-ups in. Stel vóór het toevoegen van AI-modelverbindingen de AI-versleutelingsleutel in.

Hulp krijgen

Stel vragen in de communitydiscussies en meld bugs in het communityrepository. Meld beveiligingsproblemen privé, zoals de beveiligingsbeleid uitlegt.