Sett opp Gateway på Linux

Dersom du ønsker full kontroll over operativsystemet, kan du sette opp Evolo Gateway på Linux.

Dette gir deg fleksibilitet og passer godt dersom gatewayen skal kjøre på en server eller et annet dedikert system.

Evolo Gateway kjører som en Docker-applikasjon:

• Docker lar deg opprette og kjøre applikasjoner i containere.

• Docker Compose gjør det enkelt å administrere applikasjoner som består av flere containere. Evolo Gateway settes opp med en docker-compose.yaml-fil.

Oppsettet inkluderer også Watchtower, som holder Evolo Gateway oppdatert automatisk ved å sjekke om det finnes nye versjoner av Docker-imaget.

1. Last ned og installer Docker og Docker Compose

Følg offisielle installasjonsveiledninger for din Linux-distribusjon:

CentOS
Debian
Ubuntu
Raspberry Pi OS (64-bit)

Evolo Gateway distribueres som Docker-image og støtter flere arkitekturer, inkludert vanlige Linux-servere og ARM-baserte enheter.

2. Last ned og start Evolo Gateway

Gå til ønsket mappe på enheten og last ned docker-compose.yaml:

wget https://app.evolo.no/docker/docker-compose.yaml 

Logg inn mot Evolo Docker Registry:

docker login registry.evolo.no

Kontakt oss for å få brukernavn og passord til registry.

Start Evolo Gateway:

docker compose up -d 

Dette laster ned og starter containerne. Gateway vil starte automatisk igjen etter en omstart.

Viktig om Docker-innlogging og Watchtower

Evolo Gateway henter Docker-image fra:

image: registry.evolo.no/evolotech/evolo-gateway:latest

For at Watchtower skal kunne hente nye versjoner automatisk, må Watchtower-containeren ha tilgang til Docker credentials. Dette gjøres ved å mounte Docker-konfigurasjonen inn i Watchtower-containeren.

Watchtower-delen i docker-compose.yaml bør inneholde følgende mount:

watchtower: 
  image: nickfedor/watchtower:latest 
  container_name: watchtower 
  restart: always 
  volumes: 
   - /var/run/docker.sock:/var/run/docker.sock 
   - ${HOME}/.docker/config.json:/config.json:ro 

Det er viktig at docker login og docker compose up -d kjøres som samme bruker. Da lagres Docker-innloggingen på riktig sted, og Watchtower får tilgang til riktig config.json.

Unngå å kjøre docker compose med sudo dersom innloggingen er gjort uten sudo.

Dersom docker login kjøres som én bruker, men docker compose up -d kjøres med sudo, kan Watchtower mangle tilgang til riktig Docker-innlogging.

3. Kontrollere at Evolo Gateway kjører

Du kan kontrollere at containerne kjører med:

docker ps

Du kan se logger fra Evolo Gateway med:

docker logs evolo-gateway

Du kan se logger fra Watchtower med:

docker logs watchtower

4. Neste steg

Når installasjonen er ferdig og Docker kjører Evolo Gateway, kan du fortsette med Legg til Evolo Gateway i toppsystemet.