Så går installationen till

Eurion installeras med installationskitet, en samling Ansible-roller och skript som körs på själva servern. Kitet installerar Docker, skriver all konfiguration, startar tjänsterna, kör databasmigreringar, skapar det första administratörskontot och sätter upp säkerhetskopiering, övervakning och uppdateringstjänsten.

Den här guiden beskriver en installation på en server med Docker (deploy_mode: docker), vilket är det sätt som är testat i 1.6.4.

Innan du börjar

• En server som uppfyller kraven.
• En domän där du kan skapa DNS-poster, och öppna portar enligt DNS och brandvägg.
• Installationsfilen för den aktuella versionen från Eurion, till exempel eurion-update-1.6.4.tar. Den innehåller kitet (kit.tar.gz), Eurions egna container-avbildningar (images.tar.gz), en innehållsförteckning (manifest.env) och kontrollsummor.
• Uppgifter till en SMTP-server för utgående e-post (se Utgående e-post).

Internetåtkomst under installationen

Servern hämtar paket (apt, Docker) och tredjepartsavbildningar som PostgreSQL, Redis, Kafka och Traefik från internet under installationen. Eurions egna avbildningar kommer från installationsfilen.

1. Förbered servern

Logga in på servern som en användare med sudo och installera Ansible:

sudo apt-get update
sudo apt-get install -y ansible python3-yaml

SSH på annan port än 22

Kitet slår på brandväggen ufw och släpper bara in SSH på port 22. Om SSH lyssnar på en annan port, öppna den först så att du inte låser ute dig själv:

sudo ufw allow 2222/tcp   # byt till din port

2. Packa upp installationsfilen

mkdir -p ~/eurion-install
tar -xf eurion-update-1.6.4.tar -C ~/eurion-install
cd ~/eurion-install
sha256sum -c SHA256SUMS
grep -E '^(EURION_VERSION|FROM_VERSION)=' manifest.env

sha256sum ska svara OK för varje fil. FROM_VERSION ska vara tomt: en fil med FROM_VERSION ifyllt är en deltauppdatering och kan inte användas för en ny installation.

Lägg kitet på plats:

sudo mkdir -p /opt/eurion/deploy
sudo tar -xzf kit.tar.gz -C /opt/eurion/deploy

3. Skriv konfigurationsfilen

cd /opt/eurion/deploy
sudo cp eurion-config.example.yml eurion-config.yml
sudo nano eurion-config.yml

Fyll i minst detta (alla nycklar förklaras i Konfigurationsfilen):

deploy_mode: docker
eurion_version: "1.6.4"          # samma som EURION_VERSION i manifest.env

organization:
  name: "Exempel AB"
  domain: "example.se"
  admin_email: "admin@example.se"

server:
  host: "203.0.113.10"           # serverns egen IP-adress
  public_ip: "203.0.113.10"      # den publika IP-adressen

tls:
  method: letsencrypt

smtp:
  host: "smtp.example.se"
  port: 587
  user: "eurion@example.se"
  password: "…"
  from: "Eurion <no-reply@example.se>"

eurion_version måste stämma

Avbildningarna i installationsfilen är märkta med versionsnumret. Står det något annat i eurion_version (till exempel standardvärdet latest) hittar installationen inga avbildningar och stannar.

4. Generera inställningar och lösenord

cd /opt/eurion/deploy
sudo python3 scripts/gen-config.py eurion-config.yml generated

Skriptet skapar generated/ med Ansible-variabler och generated/group_vars/secrets.yml, där alla lösenord och nycklar genereras slumpmässigt. Filen är bara läsbar för root. Kör du skriptet igen behålls de lösenord som redan finns.

5. Installera Docker och systeminställningar

cd /opt/eurion/deploy
sudo ansible-playbook -i generated/inventory/hosts.yml ansible/site.yml \
  -e @generated/group_vars/all.yml -e @generated/group_vars/secrets.yml \
  --tags prereqs

Det här steget kontrollerar att servern har minst 4 vCPU och 8 GB RAM, installerar Docker och systempaket, ställer in kärnparametrar och slår på brandväggen.

6. Läs in avbildningarna

gunzip -c ~/eurion-install/images.tar.gz | sudo docker load

7. Kör installationen

cd /opt/eurion/deploy
sudo ansible-playbook -i generated/inventory/hosts.yml ansible/site.yml \
  -e @generated/group_vars/all.yml -e @generated/group_vars/secrets.yml

Det tar normalt 5–15 minuter. Ordningen är: konfiguration → uppdateringstjänsten → databaser, Redis, Kafka, MinIO och sök → Traefik → tjänsterna → webbappen och adminportalen → övervakning → TURN-server → databasmigreringar → första administratören → kontroll → säkerhetskopiering.

Med features.ai: true hämtas språkmodellerna i slutet. Första gången kan det ta lång tid.

8. Kontrollera och logga in

sudo eurion-ctl status
sudo docker ps --filter health=unhealthy --filter status=restarting   # ska vara tom

Lösenordet till det första administratörskontot (organization.admin_email):

sudo grep initial_admin_password /opt/eurion/deploy/generated/group_vars/secrets.yml

Logga in på https://admin.example.se och https://app.example.se. Fortsätt sedan med Efter installationen.

När allt fungerar kan du ta bort uppackningskatalogen, den behövs inte längre:

rm -rf ~/eurion-install

Var saker hamnar

Vad	Var
Kitet	/opt/eurion/deploy
Din konfiguration (efter installationen)	/opt/eurion/deploy/generated/eurion-config.yml
Lösenord och nycklar (root, 0600)	/opt/eurion/deploy/generated/group_vars/secrets.yml
Compose-filer	/opt/eurion/compose/
Data (databaser, filer, sökindex)	/opt/eurion/data/
Säkerhetskopior	/opt/eurion/backups/
Loggar för uppdateringar och säkerhetskopior	/opt/eurion/logs/
Kommandot eurion-ctl	/usr/local/bin/eurion-ctl

Ändra konfigurationen senare

Se Ändra konfigurationen efter installationen.