Steg 1 av 8 · Docker

Linux med Docker

Kör install.sh på er Linux-server och öppna appliancen på port 8443.

Det här behöver ni

En Linux-server med 4 GB RAM och 20 GB ledigt diskutrymme.
Docker 24.0 eller senare med Compose v2 samt Python 3. Skriptet erbjuder sig att installera Docker om det saknas.
Åtkomst som root eller en användare med sudo.

Kör install.sh

Logga in på servern som användaren som ska äga installationen och kör:
Terminal window
```
bash <(curl -fsSL https://sslbrain.com/install.sh)
```
Acceptera skriptets förslag. Om användaren läggs till i gruppen docker stannar skriptet: logga ut och in igen och kör samma kommando.
Vänta medan skriptet hämtar appliancen, kontrollerar signaturen och startar den. Det tar upp till 5 minuter.

Öppna appliancen

Öppna adressen skriptet visar, till exempel https://192.168.1.20:8443/setup.
Fortsätt förbi webbläsarens varning för det självsignerade certifikatet.

Kontrollera att det fungerar

Skriptet visar sslbrain is running. Webbläsaren visar Logga in med sslbrain Cloud. Porten :8443 måste vara med i appliancens adress.

Nästa steg

Fortsätt med 2. Första konfigurationen.

Om det inte fungerar

Skriptet stannar med kod 2 → installera det som feltexten nämner och kör skriptet igen.
Skriptet stannar med kod 3 → signaturen kunde inte godkännas. Appliancen har inte startats. Hämta skriptet igen och se Ingen anslutning till sslbrain Cloud (EU).
Skriptet stannar med kod 4 → läs docker logs sslbrain och data/control/controller.log i installationsmappen.
Webbläsaren kan inte öppna sidan → kör docker ps. Containern sslbrain ska vara healthy och port 8443 ska vara öppen från klienten till servern.
Loggen visar Permission denied på /data → kör sudo chown -R 1000:1000 ~/sslbrain/data. Använd er installationsmapp om den är en annan.
Appliancen når inte sslbrain Cloud → kontrollera Nätverk och brandvägg.

Appliancens data

Allt som appliancen sparar ligger i katalogen data i installationskatalogen, som standard ~/sslbrain/data. Containern ser den som /data. Där ligger databasen, vaulten, appliancens nycklar och de backuper ni tar i webbgränssnittet.

Katalogen måste ägas av användare och grupp 1000. Skriptet ställer in det själv.
Radera eller flytta aldrig katalogen medan appliancen körs.
Kopiera backuper till en plats utanför servern. Se Spara en backup.
Host-controllerns logg ligger i ~/sslbrain/data/control/controller.log.

Bakom en reverse proxy

Skriv proxyns adress eller nätverk i TRUSTED_PROXIES i docker-compose.yml, t.ex. TRUSTED_PROXIES=10.0.0.5,192.168.50.0/24. Skapa sedan om containern med docker compose up -d. Utan raden litar appliancen inte på proxyns X-Forwarded-For. Körs proxyn på samma server kommer den från Docker-nätverkets gateway (docker network inspect), inte från 127.0.0.1.

Det här installerar skriptet

Ni håller själva serverns operativsystem och Docker uppdaterade.

docker-compose.yml och två publika nycklar för signaturkontroll i installationskatalogen, som standard ~/sslbrain.
Host-controllern /usr/local/bin/sslbrain-controller. Den utför de uppdateringar, omstarter och återställningar ni startar från webbgränssnittet, och startar appliancen igen om den stannar.
Cron-posten * * * * * /usr/local/bin/sslbrain-controller, som kör host-controllern varje minut.
sslbrain-shutdown.service, om servern använder systemd. Den stoppar appliancen kontrollerat när servern stängs av.

Val för skriptet

Val	Miljövariabel	Vad det gör
`--deploy-dir <sökväg>`	`DEPLOY_DIR`	Installationskatalog. Standard `~/sslbrain`.
`--yes` eller `-y`	`ASSUME_YES=1`	Svarar ja på alla frågor, t.ex. vid automatiserad installation.
`--skip-cron`	`SKIP_CRON=1`	Skapar ingen cron-post. Skriptet skriver i stället ut hur controllern ska köras.
	`DECLINE_DOCKER_INSTALL=1`	Installerar inte Docker om det saknas.
`--help`		Visar valen.

Skriptets koder

Kod	Betydelse
0	Installationen är klar.
1	Ett nödvändigt steg avböjdes, eller ett val var ogiltigt.
2	Något saknas på servern, t.ex. Docker, Compose v2 eller Python 3.
3	Signaturen på appliancens image kunde inte godkännas. Appliancen har inte startats.
4	Appliancen svarade inte inom 5 minuter.

Compose-filen från Nedladdningar

Nedladdningar i sslbrain Cloud har en compose-fil, docker-compose.yml. Den startar appliancen på port 443 med data i Docker-volymen sslbrain-data. Den installerar inte host-controllern.

Utan controllern kan appliancen inte uppdatera sig själv. Uppdatera den manuellt i katalogen med docker-compose.yml:

docker compose pull && docker compose up -d

Lägg till controllern i en befintlig installation

Sökvägarna nedan använder standardkatalogen ~/sslbrain. Välj en annan med --deploy-dir.

Kör skriptet på samma server:

bash <(curl -fsSL https://sslbrain.com/install.sh)

Skriptet hittar den körande sslbrain-containern, stoppar den och kopierar data från volymen till ~/sslbrain/data. Det behåller installationens id, licens, certifikat och port, installerar controllern och dess cron-post och startar appliancen från ~/sslbrain.
Kopiera de inställningar ni själva har ändrat, t.ex. TRUSTED_PROXIES, från er befintliga docker-compose.yml till ~/sslbrain/docker-compose.yml. Kör docker compose up -d från ~/sslbrain för att använda dem. Starta därefter bara installationen från ~/sslbrain.
Kontrollera att appliancen körs. Docker-volymen lämnas oförändrad som backup. Docker namnger den efter katalogen som compose-filen låg i, till exempel sslbrain_sslbrain-data, och skriptet skriver ut namnet. Radera den själv när appliancen körs.