Why this Configuration?
- True Data Sovereignty: 100% GDPR-compliant on-premises deployment. You own your configuration and data without vendor lock-in.
- Hardware Agnostic: Optimized and verified across low-power ARM64 SBCs (Raspberry Pi 5) and x86_64 hypervisors (Proxmox VE LXC & VM).
- Engine Freedom: Tested and supported under standard Docker Engine and unprivileged rootless Podman.
- Platform Verification: Tested on 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).
Quick Start (Standalone Docker Compose)
The snippet below is immediately ready to run in any standard Docker or Podman environment:
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 the service directly via the command line:
Docker Engine
docker compose up -d
Rootless Podman
podman compose up -d
Configuration & Environment Variables
Key configuration parameters and defaults derived from the NjordDeploy component template:
| Variable | Default Value | Description |
|---|---|---|
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). |
Ecosystem & Enterprise Integration
- Reverse Proxy Ingress Ready: Pre-configured for Caddy, Traefik, or Nginx Proxy Manager with automatic Let's Encrypt TLS certificates.
- Zero-Trust Mesh VPN: Seamless integration with WireGuard or Tailscale/Headscale mesh networks for secure remote administration.
- Transactional State Backups: Ready for point-in-time database dumps and container-safe persistent volume freezing.
Effortless Management with NjordDeploy
Deploy, monitor, and update this service with a single click on your own hardware via the NjordDeploy Configurator.