Drift

Sett opp helpdesk på server

Denne siden oppsummerer den anbefalte måten å kjøre helpdesk-en på Gigahost: VPS, Ubuntu, systemd og Caddy, med filmodus først. Nettsiden ligger på norscode.no, mens helpdesk går på helpdesk.norscode.no.

Anbefaling

Ubuntu + Caddy på Gigahost VPS

Dette er den enkleste produksjonsveien akkurat nå. Du får HTTPS, automatisk oppstart og en persistent datarot uten å måtte bytte til Postgres før du er klar.

Kjøp VPS

Velg en liten Ubuntu-basert VPS hos Gigahost. Helpdesk er lett nok til å kjøre fint på en enkel server.

Kjør som tjeneste

Bruk systemd og bash helpdesk/run slik at appen starter automatisk og holder seg i gang.

Sett opp Caddy

La Caddy terminere TLS og sende trafikken videre til 127.0.0.1:8000 på serveren.

Steg for steg

Minimal serveroppskrift

Dette er den praktiske sekvensen jeg ville brukt når helpdesk skal live.

1. Installer grunnpakker

apt update og installer git, curl, build-essential, libssl-dev og ca-certificates.

2. Installer Rust

Helpdesk-starten bygger runtime hvis den mangler, så serveren må ha cargo.

3. Lag data-mappe

Sett HELPDESK_DATA_DIR til en persistent mappe som ikke forsvinner ved restart.

4. Kjør appen

Start med PORT=8000, HELPDESK_STORAGE_BACKEND=fil og bash helpdesk/run.

5. Legg den i systemd

La tjenesten restarte automatisk og bruke samme miljøvariabler hver gang.

6. Sett opp proxy

Pek domenet til VPS-en og proxy til 127.0.0.1:8000 med Caddy eller Nginx.

Miljø

Variabler du trenger

Dette er det viktigste å sette før helpdesk starter på server.

`PORT`

Brukes av helpdesk for å lytte på riktig port på serveren.

`HELPDESK_DATA_DIR`

Peker til den persistente datamappa i filmodus.

`HELPDESK_STORAGE_BACKEND`

Sett til fil nå, og bytt til postgres når runtime-støtten finnes.

Publisering

Før du går live

Bruk denne korte sjekklisten når appen skal ut på internett for første gang.

Sjekkliste

0 av 4 fullført

Test lokalt Start tjenesten på serveren og sjekk at /api/health svarer før du peker domenet dit. Sett opp HTTPS La Caddy håndtere sertifikatet og proxy mot 127.0.0.1:8000. Verifiser data Sjekk at HELPDESK_DATA_DIR peker til en persistent mappe som ikke forsvinner ved restart. Åpne forsiden Kontroller at install-, plan- og driftssidene er tilgjengelige fra hovedadressen.

1. Test lokalt

Start tjenesten på serveren og sjekk at /api/health svarer før du peker domenet dit.

2. Sett opp HTTPS

La Caddy håndtere sertifikatet og proxy mot 127.0.0.1:8000.

3. Verifiser data

Sjekk at HELPDESK_DATA_DIR peker til en persistent mappe som ikke forsvinner ved restart.

4. Åpne forsiden

Kontroller at install-, plan- og driftssidene er tilgjengelige fra hovedadressen.

Domene

Pek domenet riktig

Dette er den enkleste måten å koble helpdesk til et eget domenenavn.

DNS

Pek A-record

Sett domenets A-record til VPS-IP-en hos Gigahost.

Proxy

Ruter trafikk

La Caddy sende forespørsler videre til helpdesk-prosessen på port 8000.

TLS

Aktiver HTTPS

Caddy henter og fornyer sertifikater automatisk når domenet peker riktig.

Klargjort

Klar til å lime inn

Bruk disse blokkene som utgangspunkt på serveren når du vil komme raskt videre.

`systemd`-service

[Unit]
Description=Helpdesk
After=network.target

[Service]
Type=simple
User=helpdesk
Group=helpdesk
WorkingDirectory=/srv/norsklang_6i
Environment=PORT=8000
Environment=HELPDESK_DATA_DIR=/var/lib/helpdesk
Environment=HELPDESK_STORAGE_BACKEND=fil
ExecStart=/bin/bash /srv/norsklang_6i/helpdesk/run
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

Caddy-config

norscode.no {
    root * /srv/www/norscode
    file_server
}

helpdesk.norscode.no {
    reverse_proxy 127.0.0.1:8000
}

Senere

Når Postgres kommer

Da kan du beholde den samme VPS-en, men bytte lagringen til database med DATABASE_URL.

Fortsatt samme server

Du trenger ikke bytte host bare fordi lagringen blir databasebasert.

Ny backend

Filmodus blir fallback, og Postgres blir primærlagring når runtime-en er klar.

Samme app

UI og API skal kunne være de samme gjennom migreringen.