Prerequisites

Before installing fossilrepo, ensure your server meets these requirements.

System Requirements

Required Software

Docker & Docker Compose

Fossilrepo runs its infrastructure stack via Docker Compose.

=== "Ubuntu/Debian"

```bash
# Install Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# Verify
docker compose version
```

=== "macOS"

```bash
# Install Docker Desktop
brew install --cask docker

# Verify
docker compose version
```

Git

Required for the sync bridge (mirroring to GitHub/GitLab).

git --version  # 2.30+

Make

Used for running common commands.

make --version

Optional: S3-Compatible Storage

For continuous backups via Litestream, you need an S3-compatible bucket:

• AWS S3
• MinIO (self-hosted)
• Backblaze B2
• DigitalOcean Spaces

!!! info "Local development" S3 is not required for local development. Litestream is disabled by default in the dev Docker Compose configuration.

Ports

The following ports are used by the stack: