OTOBO Installatie op Ubuntu

Introductie tot installatie op verschillende besturingssystemen

OTOBO is een gratis, uitgebreid open-source ticketingsysteem. In deze handleiding leer je hoe je OTOBO installeert met Docker op verschillende besturingssystemen zoals Ubuntu, Debian, CentOS, RHEL of SUSE.

Hardwarevereisten

De hardwarevereisten voor OTOBO zijn sterk afhankelijk van het gebruik. OTOBO kan worden gebruikt om enkele tickets per maand of honderden tickets per dag te verwerken. De benodigde opslagruimte varieert ook afhankelijk van het aantal tickets en de grootte van bijlagen.

Minimale vereisten

Type	CPU	RAM	Opslag
Ontwikkeling	2	4 GB	16 GB
Productie	4	8 GB	40 GB

Aanbevolen voor grootschalige systemen:

Type	CPU	RAM	SSD
Productie	4	16 GB	100 GB

SSD Opslag

SSD-opslag wordt aanbevolen om laadtijden te verkorten en de prestaties te verbeteren. Afhankelijk van het aantal tickets en bijlagen kan de benodigde opslagruimte variëren.

Grootschalig systeem, veel bijlagen

Type	CPU	RAM	SSD	HDD
Productie	4	16 GB	100 GB	1TB

Installatieopties

Er zijn twee methoden om OTOBO te installeren:

1. Standaard OTOBO-installatie
2. OTOBO-installatie met Docker (aanbevolen)

De Docker-versie wordt aanbevolen door OTOBO, omdat deze een duidelijke scheiding van systeemonderdelen (webserver, database, Redis-cache, Elasticsearch etc.) in aparte containers mogelijk maakt. Deze containers draaien in een virtuele omgeving met weinig onderlinge afhankelijkheden en kunnen gemakkelijk naar andere servers worden overgebracht.

Docker Services

Met de Docker-gebaseerde OTOBO-implementatie kun je binnen enkele minuten je eigen OTOBO-instantie operationeel krijgen. Alle afhankelijkheden zijn al opgenomen in de meegeleverde Docker-images:

• db: MariaDB wordt ingesteld als standaarddatabase.
• elastic: Elasticsearch wordt ingeschakeld voor de OTOBO-krachtige zoekfunctie.
• redis: Redis wordt gebruikt voor snelle caching.
• web: Gazelle als snelle Perl-webserver.
• nginx: Nginx dient als optionele reverse-proxy voor HTTPS-ondersteuning.

Softwarevereisten

Ondersteunde databases

• MySQL 5.6 of hoger
• MariaDB (standaard) versie 10+
• PostgreSQL 9.2 of hoger
• Oracle 10g of hoger

Vereisten

De minimale softwarevereisten die zijn getest voor installatie zijn:

• Docker 19.03.13+
• Docker Compose 1.25.0 (V2 aanbevolen)
• Git 2.17.1

OTOBO Backups

Regelmatige backups zijn belangrijk om gegevensverlies te voorkomen. Bij de ontwikkeling van het OTOBO-ticketing systeem is het raadzaam om iteratief te werk te gaan: ontwikkelingen worden eerst op een ontwikkelomgeving uitgevoerd en na voltooiing overgezet naar het productiesysteem om de kans op uitval te minimaliseren. OTOBO Backups maken

OTOBO Server Hosting

Voor het hosten van een OTOBO-server raden we het gebruik van Ubuntu 20.04 of een nieuwere versie aan. Als alternatief kun je ook Debian, CentOS, RHEL, of SUSE gebruiken. Elke server die Docker ondersteunt, kan worden gebruikt voor de installatie van OTOBO. Hieronder vind je de instructies voor het instellen van een server bij Hetzner, een populaire hostingprovider.

Serverinstelling bij Hetzner

1. Kies een Duitse locatie.
2. Kies Ubuntu 20.04+ als besturingssysteem.
3. Gebruik een configuratie met minimaal 4 GB RAM.
4. Maak de server aan.

::: note OS Keuze In plaats van Ubuntu kun je ook Debian, RHEL, CentOS of SUSE gebruiken. :::

Serverlocatie

Kies een serverlocatie bij jou in de buurt om de latentie te minimaliseren. Bovendien kan de locatie juridische vereisten beïnvloeden. Vanwege de AVG moeten servers in de EU worden gehost.

Serverauthenticatie

Gebruik SSH (Public-Private Key) voor serverauthenticatie, omdat dit veiliger en praktischer is. Je kunt een reeds bestaand sleutelpaar gebruiken of een nieuw paar aanmaken. Een extra wachtwoordzin voor de private key verhoogt de veiligheid.

Compatibiliteit

Ondersteunde Ubuntu LTS-versies waarvoor Docker Engine en Docker Compose v2 probleemloos kunnen worden geïnstalleerd:

• Ubuntu 20.04 LTS (Focal)
• Ubuntu 22.04 LTS (Jammy)
• Ubuntu 24.04 LTS (Noble)

Andere Ubuntu-versies werken doorgaans ook, zolang Docker Engine en de docker-compose-plugin (v2) uit de officiële Docker-repository beschikbaar zijn.

---

Installatie van Docker en Git

Update en installeer vereiste pakketten

sudo apt update
sudo apt install ca-certificates curl gnupg lsb-release

Docker Repository instellen

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Repository toevoegen

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Docker Engine en Docker Compose Plugin installeren

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Installatie controleren

Docker testen

sudo docker run hello-world

Als alles correct is geïnstalleerd, toont de testcontainer een bevestiging.

Docker Compose (v2) testen

docker compose version

Optioneel: Gebruiker toevoegen aan de Docker-groep

sudo usermod -aG docker $USER

Log uit en weer in (of herstart) zodat de wijziging van kracht wordt.

---

OTOBO Installeren (gemeenschappelijke stappen)