Self-Hosting

Why self-host?

For some teams, using a hosted SaaS product for project management is a non-starter. Your organisation might have data residency requirements, a security policy that prohibits third-party data processors, or simply a preference for owning your own stack.

Sayr is built with self-hosting as a first-class concern. The same codebase that runs sayr.io is the same codebase you deploy yourself.

Source availablee

The full Sayr source code is available on GitHub at github.com/dorasto/sayr. Every line of the backend, frontend, and worker is public. Fork it, inspect it, contribute to it.

What you need to deploy

Docker — all services are containerised
PostgreSQL — your primary database
Redis — for the job queue
S3-compatible storage — for file uploads (MinIO works, as does any S3-compatible provider)
A domain with DNS control (for your subdomain portal at {org}.yourdomain.com)

How it works

Pull the Docker images

All Sayr services are published as Docker images. Use the provided docker-compose.yml as your starting point and configure via environment variables.

Point at your database and storage

Set your PostgreSQL connection string, Redis URL, and S3-compatible storage credentials. Run the database migrations and the schema is ready.

Configure your domain and OAuth

Set your base domain and configure whichever OAuth providers you want to offer. Your public portal will be accessible at {org-slug}.yourdomain.com automatically.