Atrium

A self-hosted client portal for agencies and freelancers.

Website | Documentation | GitHub Issues

Created by @edgarjc -- Built out of frustration with the tools I was using to manage client work.

License: ELv2

Why Atrium?

Most agencies juggle shared drives, spreadsheets, and scattered emails to keep clients in the loop. Atrium replaces all of that with a single branded portal your clients can log into -- no more "can you resend that file?" emails. Unlike managed SaaS platforms, you own the data and host it yourself.

Features

Client portal

• Branded portal -- Clients log in to a portal with your logo, colors, branded login page, and optionally your own domain with automatic SSL
• Projects & updates -- Post progress updates with images and embedded content (YouTube, Loom, Figma, Google Docs, Canva, and more); clients see a clear current status
• Files & links -- Upload deliverables or link external content (Nextcloud, Drive, Notion); stored on local disk, S3, MinIO, or Cloudflare R2
• Tasks & client requests -- Task board with statuses, assignees, labels, and drag-and-drop ordering; clients can submit requests from the portal
• Comments & notifications -- Threaded discussion on updates and tasks, with in-app, email, and web push notifications
• View as customer -- Preview the portal exactly as a client sees it, with mutations blocked

Get paid

• Invoicing -- Draft, send, and track invoices with PDF generation and in-app preview
• Online payments -- Clients pay invoices via Stripe Checkout (Direct Keys or Connect)
• Time tracking -- Timers and manual entries per project and task, hourly rates, and one-click invoices from un-invoiced time
• Reports -- Time reports by project, user, and task, with CSV export

Contracts & approvals

• Documents -- Send quotes, contracts, and NDAs for client acknowledgement or approval
• E-signatures -- Signature fields, signing order, reminders, expiry, and a signed certificate with full audit trail
• Decisions -- Ask clients to vote on options directly in the portal

Run the agency

• Calendar -- Tasks, project dates, and invoice due dates on a month grid or agenda
• Team & roles -- Invite owners and admins to your team; clients join as members with access to their projects only
• Multiple organizations -- Run several companies from one install and switch between them; close public signups with ALLOW_SIGNUPS=false
• Global search -- Full-text search across projects, files, tasks, clients, and updates
• Tags & labels -- Cross-entity labels for projects, tasks, files, and people
• Internal notes -- Admin-only notes on each project
• Data export -- CSV export for projects, invoices, people, tasks, and time entries

Platform

• MCP server -- Connect Claude, ChatGPT-style agents, or local models to manage your workspace via OAuth sign-in or API keys (docs)
• Authentication -- Email/password and magic link via Better Auth; admins can issue password reset links
• Dark mode -- Per-user toggle, follows the system by default
• Email -- Resend or any SMTP server, configurable per organization
• Self-hosted -- Single Docker image with bundled Postgres option, Unraid template, ARM support; optional anonymous crash reporting (Telemetry)

Tech Stack

Getting Started

Local Development

Prerequisites: Bun (v1.0+) and Docker (for PostgreSQL).

git clone https://github.com/Vibra-Labs/Atrium.git
cd atrium
bun install
bun run setup
bun run dev

This starts the web app at localhost:3000 and the API at localhost:3001. The setup script handles env files, database, and seed data automatically.

Docker (Production)

A pre-built image is available on Docker Hub:

docker pull vibralabs/atrium:latest

The quickest way to run Atrium with PostgreSQL:

curl -O https://raw.githubusercontent.com/Vibra-Labs/Atrium/main/docker-compose.yml
BETTER_AUTH_SECRET=$(openssl rand -base64 32) \
POSTGRES_PASSWORD=your-secure-password \
docker compose up -d

Or build from source:

git clone https://github.com/Vibra-Labs/Atrium.git
cd atrium
docker compose up --build -d

The unified image (vibralabs/atrium) bundles the API, web app, and a Caddy reverse proxy into a single container on port 8080. It works with any container platform — Docker Compose, Coolify, Portainer, Unraid, etc.

First Use

1. Open localhost:3000/signup and create your account
2. Create projects, upload files, and manage statuses from the dashboard
3. Invite clients by email -- they access the client portal at /portal

Locked out of two-factor?

Use a recovery code or another passkey, or ask a workspace owner to turn off your two-factor (which also removes passkeys) from the team page. If you run the server and nobody else can, see Two-factor authentication for the reset command.

Documentation

• Docker Deployment
• Portainer
• Unraid
• MCP Server
• Configuration & Environment Variables
• Stripe Payments Setup
• Development Guide & Scripts
• Security

Roadmap

Recurring invoices, SAML/SSO, webhooks, workflow automations, and more. See the full Roadmap.

Contributing

Contributions are welcome! Here's how to get involved:

1. Open an issue first -- Whether it's a bug report, feature idea, or improvement, start with a GitHub Issue so we can discuss before you write code.
2. Keep PRs focused -- Small, single-purpose pull requests are easier to review and merge.
3. Bug fixes and improvements welcome -- New features should be discussed in an issue first to make sure they align with the project direction.

Community & Support

• Bug reports & feature requests -- GitHub Issues
• Questions & discussions -- GitHub Discussions

If you find Atrium useful, consider giving it a star -- it helps others discover the project.

License

Atrium is source-available software licensed under the Elastic License 2.0 (ELv2). You are free to use, modify, and self-host Atrium. The license restricts offering it as a managed service to third parties.