Installation

Requirements

Before you install FediSuite, make sure you have everything you need. The requirements are intentionally kept lean — a small server is more than sufficient.

On this page

Server or VPS

FediSuite runs entirely via Docker, so a small Linux server or an affordable cloud VPS is perfectly sufficient. Your own hardware works just as well.

Minimum

  • ✓ 1 vCPU
  • ✓ 1 GB RAM
  • ✓ 20 GB storage
  • ✓ Public IPv4 address

Recommended

  • → 2 vCPU
  • → 2 GB RAM
  • → 40 GB storage
  • → SSD storage
Operating system: Ubuntu 22.04 LTS or Debian 12 are recommended. Other Linux distributions work as well, as long as Docker is supported. Windows and macOS are not recommended for production use.

Domain & DNS

You need a domain that points to the public IP address of your server. Traefik automatically handles TLS certificates via Let's Encrypt — no manual SSL configuration required.

DNS configuration

A fedisuite.your-domain.com 1.2.3.4 (your server IP) Required
A www.fedisuite.your-domain.com 1.2.3.4 (optional)
Note: DNS changes can take up to 24 hours to propagate worldwide. Wait a few minutes after setting up DNS before starting the installation.

Software

Only two things need to be installed on the server: Docker and Docker Compose. Everything else — database, cache, reverse proxy — is started automatically via Docker Compose.

Docker Engine ≥ 24.0
Required

The container runtime. Installable via the official Docker repository.

Docker Compose ≥ 2.0
Required

As a plugin (docker compose) or standalone (docker-compose). Controls the entire FediSuite stack.

Traefik v3
Required

Reverse proxy and TLS termination via Let's Encrypt. Runs directly in the Docker Compose stack — no separate setup required.

Git any
Optional

For cloning the FediSuite Docker repository. Already pre-installed on most systems.

Network & Ports

Traefik requires two open ports. These must be allowed through your server's firewall and must not be occupied by other services.

Port Protocol Purpose
80 TCP HTTP (redirect to HTTPS)
443 TCP HTTPS / TLS (Let's Encrypt)
Important: If another web server (Nginx, Apache) is already running on port 80 or 443, it must be removed or reconfigured first. Traefik takes over this role entirely.

What you don't need

FediSuite includes everything it needs in the Docker Compose stack. You do not need to separately install or configure the following:

Nginx / Apache — Traefik handles the reverse proxy
MySQL / PostgreSQL — Started as part of the Docker Compose stack
Redis — Started as part of the Docker Compose stack
PHP / Node.js — Runs entirely in Docker containers
SSL certificates (manual) — Traefik automatically obtains Let's Encrypt certificates

← Back

Feature Overview

Next step →

Docker Installation