EasySafe Server — Installation

Installation

Prerequisites

Linux server with Docker (compose v2), ports 80/443 reachable
DNS A records for your domain and the wildcard: coder.firma.de and *.coder.firma.de → server IP
Outbound access to docker.easy-safe.eu (workspace images)

Install via APT (Debian/Ubuntu)

echo "deb [arch=amd64 trusted=yes] https://apt.easy-safe.eu stable main" | sudo tee /etc/apt/sources.list.d/easysafe.list
sudo apt update
sudo apt install easysafe-server

Beta channel instead:

echo "deb [arch=amd64 trusted=yes] https://apt.easy-safe.eu/beta stable main" | sudo tee /etc/apt/sources.list.d/easysafe.list

Direct download (without APT): easysafe-server_amd64.deb — install with sudo dpkg -i easysafe-server_amd64.deb.

Setup

sudo easysafe-server setup

The setup asks for your domain (CODER_DOMAIN) and the admin account, starts the stack (Caddy / Coder / Postgres) and publishes the workspace template. Every user then gets private workspace containers (VS Code, Capella, LibreOffice, LSP) behind one login. Re-running the setup is safe — it only updates.

Commands

Command	Description
`easysafe-server setup`	First configuration + start + template publish
`easysafe-server start`	Start the containers
`easysafe-server stop`	Stop the containers (data is kept)
`easysafe-server status`	Show container status
`easysafe-server update`	Pull new images and restart the containers

Updates

Server package: sudo apt upgrade (APT install) or install the new .deb
Workspace images: sudo easysafe-server update — running workspaces are never touched; users see Update available in Coder and get the new state on the next workspace start