tiny vps - nself-org/cli GitHub Wiki

Tiny VPS Setup

Running ɳSelf on a server with less than 1 GB of RAM requires the tiny profile. The tiny profile starts Postgres and nginx only. Hasura and Auth are opt-in.


When to use the tiny profile

RAM Recommendation
< 512 MB Tiny profile required
512 MB – 1 GB Tiny profile recommended
1 GB + Standard profile works

ɳSelf detects available RAM at init time and prints a warning when it is below 512 MB.


Getting started

nself init --profile=tiny --accept-defaults
nself build
nself start

This generates a .env.dev with only Postgres and nginx enabled.


What the tiny profile includes

Service Status
Postgres Enabled
Nginx Enabled
Hasura Disabled (opt-in)
Auth Disabled (requires Hasura)
Redis Disabled
MinIO Disabled
Functions Disabled
Monitoring Disabled
Plugins Disabled (enable per-plugin after adding RAM)

Enabling Hasura when you have more RAM

Once you upgrade to a server with 1 GB+ RAM:

  1. Edit .env.dev and set:
ENABLE_HASURA=true
HASURA_GRAPHQL_ADMIN_SECRET=your_secret_here
HASURA_JWT_KEY=your_jwt_key_here
  1. Rebuild and restart:
nself build
nself start

Tradeoffs

  • No GraphQL API (Hasura disabled). You can query Postgres directly via raw SQL.
  • No authentication service. Build your own auth layer or enable Hasura Auth later.
  • No plugin support. Plugins require at least Hasura for schema management.

Upgrade path

When you upgrade your VPS:

  1. Increase RAM to at least 1 GB.
  2. Re-run init with the standard profile:
nself init --profile=standard --force
nself build
nself start

Related pages


Home | _Sidebar

⚠️ **GitHub.com Fallback** ⚠️