vibralabs/atrium repository overview

⁠Atrium

A self-hosted client portal for agencies and freelancers.

⁠What is Atrium?

Atrium replaces shared drives, spreadsheets, and scattered emails with a single branded portal your clients can log into. You own the data and host it yourself.

⁠Features

• Project management — Customizable status pipeline per organization
• File sharing — Upload and deliver files via S3, MinIO, Cloudflare R2, or local storage
• White-label branding — Custom colors and logo applied to the client portal
• Role-based access — Owner/admin roles for your team, member role for clients
• Email notifications — Transactional email via Resend
• Built-in database — PostgreSQL included, no separate container needed

⁠Quick Start

The only required variable is BETTER_AUTH_SECRET:

docker run -d \
  --name atrium \
  -p 8080:8080 \
  -v atrium-db:/var/lib/postgresql/data \
  -v atrium-uploads:/app/uploads \
  -e BETTER_AUTH_SECRET=$(openssl rand -base64 32) \
  vibralabs/atrium:latest

Open http://localhost:8080 and create your account.

⁠Docker Compose

services:
  atrium:
    image: vibralabs/atrium:latest
    ports:
      - "8080:8080"
    environment:
      BETTER_AUTH_SECRET: "change-me-to-a-random-string-at-least-32-chars"
    volumes:
      - atrium-db:/var/lib/postgresql/data
      - atrium-uploads:/app/uploads
    restart: unless-stopped

volumes:
  atrium-db:
  atrium-uploads:

⁠Using an External Database

Disable the built-in PostgreSQL and provide your own connection string:

environment:
  USE_BUILT_IN_DB: "false"
  DATABASE_URL: "postgresql://user:password@your-db-host:5432/atrium"
  BETTER_AUTH_SECRET: "your-secret-here"

⁠Environment Variables

⁠Volumes

⁠Links

• Documentation⁠
• GitHub⁠
• Issues⁠