Self-Hosting

LifyGo can be deployed on any Linux server capable of running Docker. A small VPS (such as a DigitalOcean Droplet or Hetzner Cloud instance) is sufficient for most deployments.

Prerequisites

Ubuntu 22.04 or newer
Docker
Docker Compose
A domain name pointing to your server
An SMTP account (Gmail, Zoho, or another provider)

1. Clone the Repository

git clone https://github.com/lifygo/lifygo.git
cd lifygo

2. Configure the Environment

cp apps/api/.env.example apps/api/.env

Update the .env file with your configuration. At minimum:

AUTH_PROVIDER=local
JWT_SECRET=a-long-random-string
DATABASE_URL=postgres://lifygo:yourpassword@localhost:5432/lifygo?sslmode=disable
REDIS_URL=redis://localhost:6379
ENCRYPTION_KEY=$(openssl rand -hex 32)

3. Start Infrastructure

docker compose -f infra/docker/docker-compose.yml up -d

4. Run Database Migrations

cd apps/api

migrate \
  -path migrations \
  -database "postgres://lifygo:yourpassword@localhost:5432/lifygo?sslmode=disable" \
  up

5. Configure Nginx

A sample Nginx configuration is available in:

infra/nginx/

The configuration:

Proxies requests to the API
Proxies requests to the dashboard
Supports HTTPS with Let’s Encrypt

6. Access the Dashboard

Open your browser and visit:

https://your-domain.com

Maintenance

To keep your deployment healthy:

Regularly back up your PostgreSQL database.
Keep your ENCRYPTION_KEY safe. Without it, encrypted SMTP passwords cannot be recovered.
Pull the latest repository changes and restart your Docker containers when updating LifyGo.

​Self-Hosting

​Prerequisites

​1. Clone the Repository

​2. Configure the Environment

​3. Start Infrastructure

​4. Run Database Migrations

​5. Configure Nginx

​6. Access the Dashboard

​Maintenance