Self-Hosting Guide

Deploy Super Family products on your own infrastructure. Complete control, zero ongoing costs, no vendor lock-in.

System Requirements

Minimal (1-10 users)

  • • 2 CPU cores
  • • 4 GB RAM
  • • 20 GB storage
  • • 10 Mbps bandwidth

Best for: Docker Compose on single server

Recommended (10-100 users)

  • • 4 CPU cores
  • • 8 GB RAM
  • • 100 GB storage
  • • 100 Mbps bandwidth

Best for: Docker Compose or lightweight K8s

Production (100+ users)

  • • 8+ CPU cores
  • • 16+ GB RAM
  • • 500+ GB storage
  • • 1 Gbps bandwidth

Best for: Kubernetes cluster with load balancing

Deployment Options

Docker Compose

One-command local deployment with all services pre-configured

Time: 5 minutes

docker-compose up -d

Kubernetes

Production-ready Helm charts for cluster deployment

Time: 15 minutes

helm install super-family ./charts

Managed Cloud

We handle hosting, backups, and 99.9% uptime SLA

Time: 2 minutes

Sign up and deploy instantly

One-Click Deploys

Deploy to Railway, Render, or Fly.io with one click

Time: 3 minutes

Click "Deploy" button

Quick Start: Docker Compose

Get all four products running on a single server in 5 minutes.

1

Clone the Repository

Get the latest Super Family monorepo with all four products.

git clone https://github.com/ftrflds/super.git
cd super
2

Configure Environment

Set database credentials, email server, domain names, and API keys.

cp .env.example .env
nano .env  # Edit with your settings
3

Start Services

Starts all containers: Postgres, Redis, and all four products. Takes ~2 minutes.

docker-compose up -d
4

Verify Deployment

Check that all services are running. Access at http://localhost:3000

docker-compose ps
docker-compose logs -f

Production: Kubernetes

Deploy to Kubernetes for high availability, auto-scaling, and zero-downtime updates.

1

Add Helm Repository

Add the official Super Family Helm chart repository.

helm repo add super-family https://charts.super.software
helm repo update
2

Create Values File

Configure domains, ingress, persistence, and resource limits.

helm show values super-family/super > values.yaml
nano values.yaml  # Customize for your cluster
3

Install Chart

Deploy to Kubernetes. Includes PostgreSQL, Redis, and all products.

helm install super super-family/super -f values.yaml -n super-family --create-namespace
4

Verify Deployment

Check pod status and logs. Configure DNS and TLS certificates.

kubectl get pods -n super-family
kubectl logs -n super-family -l app=super-family -f

Environment Variables

Required configuration for self-hosting. All products share a single .env file.

Database

DATABASE_URL

PostgreSQL connection string

Example: postgresql://user:pass@localhost:5432/super

REDIS_URL

Redis connection string (for caching)

Example: redis://localhost:6379

Email

SMTP_HOST

Email server hostname

Example: smtp.gmail.com

SMTP_PORT

Email server port

Example: 587

SMTP_USER

Email account username

Example: noreply@yourcompany.com

SMTP_PASSWORD

Email account password

Example: your-app-password

Domain Configuration

SUPERMARK_URL

Public URL for Supermark

Example: https://mark.yourcompany.com

SUPERSIGN_URL

Public URL for Supersign

Example: https://sign.yourcompany.com

SUPERFORMS_URL

Public URL for Superforms

Example: https://forms.yourcompany.com

SUPERCAL_URL

Public URL for Supercal

Example: https://cal.yourcompany.com

Security

JWT_SECRET

Secret for signing tokens (generate randomly)

Example: openssl rand -hex 32

ENCRYPTION_KEY

Key for field-level encryption

Example: openssl rand -hex 32

Migrating from Competitors

Switching from DocuSign, Calendly, or other tools? Here's how to migrate your data.

DocuSign → Supersign

  1. 1. Export templates and completed documents from DocuSign
  2. 2. Import templates via Supersign bulk upload API
  3. 3. Migrate active envelopes (in-progress signatures)
  4. 4. Update email templates and branding

Calendly → Supercal

  1. 1. Export meeting types and availability rules
  2. 2. Recreate meeting types in Supercal dashboard
  3. 3. Update calendar sync (Google/Outlook)
  4. 4. Replace booking links in email signatures and website

Getting Help

Documentation

Detailed setup guides for each product with troubleshooting tips.

Read Docs

Community Support

Ask questions and get help from other self-hosters on GitHub Discussions.

Join Community

Professional Support

Need white-glove setup or custom deployment? We offer paid support packages.

Contact Us

Prefer Managed Hosting?

Don't want to manage infrastructure? Try our managed cloud service. We handle hosting, backups, and updates.

View PricingStart Free Trial