Phonemos User Guide

Single-Server Linux Installation

The easiest way to deploy Phonemos on a single VM or physical server. This setup uses Docker Compose to run Phonemos and all its dependencies as containers on a single Linux host, managed by systemd. Everything is included: the application, a reverse proxy (Nginx), authentication (Keycloak), object storage (MinIO), and the database (PostgreSQL).

Prerequisites

  • A Linux-based system (Ubuntu recommended)

  • Docker installed

  • At least 100 GB of disk space

  • Root access or sudo privileges

Quick Start

  1. Clone the repository to /opt/phonemos-linux

  2. Run sudo ./setup-phonemos.sh

  3. Follow the interactive setup (hostname, TLS, data directory)

  4. Complete the post-install steps (DNS, Keycloak configuration, service startup)

The setup script handles everything automatically: Docker installation, user creation, network setup, certificate configuration, image pulling, and systemd service registration.

More information