Trin 1 af 8 · Docker

Linux med Docker

Kør install.sh på jeres Linux-server, og åbn appliancen på port 8443.

Det skal I bruge

En Linux-server med 4 GB RAM og 20 GB fri disk.
Docker 24.0 eller nyere med Compose v2 samt Python 3. Scriptet tilbyder at installere Docker, hvis det mangler.
Adgang som root eller en bruger med sudo.

Kør install.sh

Log ind på serveren som den bruger, der skal eje installationen, og kør:
Terminal window
```
bash <(curl -fsSL https://sslbrain.com/install.sh)
```
Acceptér scriptets forslag. Tilføjes brugeren til gruppen docker, stopper scriptet: log ud og ind igen, og kør samme kommando.
Vent, mens scriptet henter appliancen, kontrollerer signaturen og starter den. Det tager op til 5 minutter.

Åbn appliancen

Åbn adressen, scriptet viser, fx https://192.168.1.20:8443/setup.
Fortsæt forbi browserens advarsel om det selvsignerede certifikat.

Kontrollér, at det virker

Scriptet viser sslbrain is running. Browseren viser Log ind med sslbrain Cloud. Porten :8443 skal med i appliancens adresse.

Næste skridt

Fortsæt med 2. Første opsætning.

Hvis det fejler

Scriptet stopper med kode 2 → installér det, fejlteksten nævner, og kør scriptet igen.
Scriptet stopper med kode 3 → signaturen kunne ikke godkendes. Appliancen er ikke startet. Hent scriptet igen, og se Ingen forbindelse til sslbrain Cloud (EU).
Scriptet stopper med kode 4 → læs docker logs sslbrain og data/control/controller.log i installationsmappen.
Browseren kan ikke åbne siden → kør docker ps. Containeren sslbrain skal være healthy, og port 8443 skal være åben fra klienten til serveren.
Loggen viser Permission denied på /data → kør sudo chown -R 1000:1000 ~/sslbrain/data. Brug jeres installationsmappe, hvis den er en anden.
Appliancen kan ikke nå sslbrain Cloud → kontrollér Netværk og firewall.

Appliancens data

Alt, hvad appliancen gemmer, ligger i mappen data i installationsmappen, som standard ~/sslbrain/data. Containeren ser den som /data. Her ligger databasen, vault’en, appliancens nøgler og de backups, I tager i webfladen.

Mappen skal ejes af bruger og gruppe 1000. Scriptet sætter det selv.
Slet eller flyt aldrig mappen, mens appliancen kører.
Hent backups ud af serveren. Se Gem en backup.
Host-controllerens log ligger i ~/sslbrain/data/control/controller.log.

Bag en reverse proxy

Skriv proxyens adresse eller netværk i TRUSTED_PROXIES i docker-compose.yml, fx TRUSTED_PROXIES=10.0.0.5,192.168.50.0/24. Opret derefter containeren igen med docker compose up -d. Uden linjen stoler appliancen ikke på proxyens X-Forwarded-For. Kører proxyen på samme server, kommer den fra Docker-netværkets gateway (docker network inspect), ikke fra 127.0.0.1.

Det installerer scriptet

Serverens styresystem og Docker holder I selv opdateret.

docker-compose.yml og to offentlige nøgler til signaturkontrol i installationsmappen, som standard ~/sslbrain.
Host-controlleren /usr/local/bin/sslbrain-controller. Den udfører de opdateringer, genstarter og gendannelser, I starter fra webfladen, og starter appliancen igen, hvis den stopper.
Cron-posten * * * * * /usr/local/bin/sslbrain-controller, som kører host-controlleren hvert minut.
sslbrain-shutdown.service, hvis serveren bruger systemd. Den stopper appliancen pænt, når serveren lukker ned.

Valg til scriptet

Valg	Miljøvariabel	Hvad det gør
`--deploy-dir <sti>`	`DEPLOY_DIR`	Installationsmappe. Standard `~/sslbrain`.
`--yes` eller `-y`	`ASSUME_YES=1`	Svarer ja til alle spørgsmål, fx til automatisk installation.
`--skip-cron`	`SKIP_CRON=1`	Opretter ingen cron-post. Scriptet skriver, hvordan controlleren køres i stedet.
	`DECLINE_DOCKER_INSTALL=1`	Installerer ikke Docker, hvis det mangler.
`--help`		Viser valgene.

Scriptets koder

Kode	Betydning
0	Installationen er gennemført.
1	Et nødvendigt trin blev afvist, eller et valg var ugyldigt.
2	Noget mangler på serveren, fx Docker, Compose v2 eller Python 3.
3	Signaturen på appliancens image kunne ikke godkendes. Appliancen er ikke startet.
4	Appliancen svarede ikke inden for 5 minutter.

Compose-filen fra Downloads

Downloads i sslbrain Cloud har en compose-fil, docker-compose.yml. Den starter appliancen på port 443 med data i Docker-volumet sslbrain-data. Den installerer ikke host-controlleren.

Uden controlleren kan appliancen ikke opdatere sig selv. Opdatér den i hånden i mappen med docker-compose.yml:

docker compose pull && docker compose up -d

Tilføj controlleren til en eksisterende installation

Stierne nedenfor bruger standardmappen ~/sslbrain. Vælg en anden med --deploy-dir.

Kør scriptet på samme server:

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

Scriptet finder den kørende sslbrain-container, stopper den og kopierer data fra volumet til ~/sslbrain/data. Det bevarer installationens id, licens, certifikater og port, installerer controlleren og dens cron-post og starter appliancen fra ~/sslbrain.
Kopiér de indstillinger, I selv har ændret, fx TRUSTED_PROXIES, fra jeres eksisterende docker-compose.yml til ~/sslbrain/docker-compose.yml. Kør docker compose up -d fra ~/sslbrain for at bruge dem. Start derefter kun installationen fra ~/sslbrain.
Tjek, at appliancen kører. Docker-volumet bliver liggende uændret som backup. Docker navngiver det efter mappen, compose-filen lå i, fx sslbrain_sslbrain-data, og scriptet skriver navnet. Slet det selv, når appliancen kører.