Waarom deze configuratie?
- Echte data-soevereiniteit: 100% AVG/GDPR compliant. Lokale gegevens en configuratie blijven op eigen hardware zonder cloud-afhankelijkheid.
- Hardware agnostisch: Geoptimaliseerd voor Raspberry Pi 5 (ARM64) en Proxmox VE hypervisors (x86_64 LXC & VM).
- Engine vrijheid: Getest en gevalideerd voor Docker CE en rootless Podman zonder root-privileges.
- Platform verificatie: Getest op Proxmox LXC: docker (24.04, 2026-10-20), podman (24.04, 2026-10-20); Proxmox VM: docker (24.04, 2026-10-20), podman (24.04, 2026-10-20).
Snelle Start (Standalone Docker Compose)
Onderstaand compose-fragment is direct te gebruiken in elke Docker- of Podman-omgeving:
services:
speaches:
container_name: njorddeploy-speaches
image: "ghcr.io/speaches-ai/speaches:latest-cpu"
volumes:
- "./data/speaches/cache:/home/ubuntu/.cache/huggingface/hub"
ports:
- "8008:8000"
environment:
- "WHISPER__COMPUTE_TYPE=default"
- 'PRELOAD_MODELS=["Systran/faster-whisper-small"]'
- "API_KEY=speaches"
networks:
- njorddeploy_net
restart: unless-stopped
networks:
njorddeploy_net:Start de service direct via de commandline:
Docker Engine
docker compose up -d
Rootless Podman
podman compose up -d
Configuratie & Omgevingsvariabelen
Belangrijkste configuratieparameters en standaardwaarden uit de NjordDeploy component-sjabloon:
| Variabele | Standaardwaarde | Beschrijving |
|---|---|---|
SPEACHES_PORT |
8008 |
The host port to expose the Speaches STT/TTS API. |
SPEACHES_MODEL |
Systran/faster-whisper-small |
Whisper spraakmodel voor transcriptie. 'Systran/faster-whisper-small' is de aanbevolen standaard voor uitstekend Nederlands op standaard CPU (~1 GB RAM). |
SPEACHES_COMPUTE_TYPE |
default |
Whisper compute type (e.g. default, int8, float16, int8_float16). |
Ecosysteem & Bedrijfsintegratie
- Reverse Proxy Klaar: Direct te koppelen met Caddy, Traefik of Nginx Proxy Manager inclusief automatische Let's Encrypt TLS.
- Veilige Remote Toegang: Naadloos te combineren met WireGuard of Tailscale/Headscale voor veilige toegang buiten het lokale netwerk.
- Transactieve Back-ups: Geschikt voor point-in-time database dumps en container-safe volume snapshotting via NjordDeploy.
Eenvoudig beheren via NjordDeploy
Installeer, bewaak en update deze service met 1 klik op uw eigen Raspberry Pi of Proxmox server via de NjordDeploy Configurator.