Installeren

Wat je nodig hebt

Een Linux-machine met systemd en roottoegang, op x86-64 of ARM64. Heeft de machine geen Docker, dan installeert het script dat erbij. Op deze machine draait het paneel, en hij wordt je eerste node.

Het paneel installeren

Voer dit uit op die machine:

$ curl -fsSL https://getatlas.gg/install.sh | sudo sh

Het script controleert de handtekening van de release voordat het iets uitvoert, en toont daarna het adres van het paneel. Zonder domein antwoordt het paneel via gewoon HTTP op poort 8080.

Je instellingen en de gemaakte geheimen staan in /opt/atlas/.env. Maak een back-up van dat bestand.

Je netwerk instellen

Open het adres van het paneel in een browser. De installatie vraagt om:

  1. Een naam voor het netwerk, en het account van de eigenaar.
  2. Een licentiesleutel, als je die hebt. Zonder sleutel draait het paneel op Free.
  3. De eerste node. Gebruik deze machine met één klik, of voeg een andere toe met een join-opdracht of via SSH.
  4. Een domein, als je dat wilt. Atlas zet het paneel dan over op HTTPS en sluit poort 8080.

Later een domein toevoegen

Laat het domein naar de machine wijzen en voer het script opnieuw uit met het domein erbij:

$ curl -fsSL "https://getatlas.gg/install.sh?domain=panel.example.com" | sudo sh

Andere sites hosten

Als Atlas Caddy voor je domein draait, serveert die Caddy ook elk .caddy-bestand in /opt/atlas/caddy/sites/. Updates laten de map met rust. Heeft een site een backend nodig, draai die dan als container op het netwerk atlas_default en stuur er op naam naartoe:

map.caddy
map.example.com {
	reverse_proxy overviewer:80
}

Herlaad Caddy nadat je een bestand toevoegt of wijzigt:

$ docker compose -f /opt/atlas/compose.yaml exec caddy caddy reload --config /etc/caddy/Caddyfile

Zit er een fout in een bestand, dan weigert Caddy het en blijven de sites op de oude configuratie draaien. Herstel of verwijder het bestand voor de volgende update, want daarmee start Caddy niet.

Bijwerken

$ sudo atlas update

Dit haalt de nieuwste release van je huidige hoofdversie op. Voeg --major toe om naar een nieuwe hoofdversie te gaan, of --channel stable om van kanaal te wisselen.

Verwijderen

$ sudo atlas uninstall

Je typt eerst uninstall voordat er iets verdwijnt. Voeg --keep-data toe om de bestanden van je servers, je instellingen en de database te bewaren.