refactor: enhance installation process with support for full-stack and app-only modes, update environment configurations, and improve database migration handling

2026-06-13 21:23:28 +03:00
parent 17ff60faea
commit 0f89d9f627
17 changed files with 620 additions and 51 deletions
@@ -0,0 +1,89 @@
+# Self-Hosting Deployment
+
+Neta has two Docker modes.
+
+## Full-Stack Mode
+
+Use this when the server should run Neta and the bundled Supabase-compatible stack.
+
+Compose file:
+
+```bash
+docker-compose.full.yml
+```
+
+Services:
+
+- `neta-web`: Next.js app
+- `neta-db`: Postgres with pgvector
+- `neta-auth`: Supabase Auth
+- `neta-rest`: PostgREST
+- `neta-storage`: Supabase Storage with local disk backend
+- `neta-supabase-proxy`: single public API entrypoint
+- `neta-migrations`: one-shot Neta database migration runner
+
+Generate production secrets:
+
+```bash
+node scripts/generate-full-stack-env.mjs > .env
+```
+
+Then adjust these values before starting:
+
+- `NEXT_PUBLIC_SITE_URL`: public Neta URL
+- `NEXT_PUBLIC_SUPABASE_URL`: public bundled Supabase API URL
+- `NETA_PORT`: host port for Neta when deploying directly with Docker
+- `SUPABASE_API_PORT`: host port for the bundled Supabase API
+- `POSTGRES_PORT`: host port for backup/manual DB access
+
+Start:
+
+```bash
+docker compose -f docker-compose.full.yml up -d --build
+```
+
+## App-Only Mode
+
+Use this when Neta connects to an existing Supabase or Supabase-compatible backend.
+
+Compose file:
+
+```bash
+docker-compose.yml
+```
+
+Required env values:
+
+- `NEXT_PUBLIC_SITE_URL`
+- `NEXT_PUBLIC_SUPABASE_URL`
+- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+- `SUPABASE_SERVICE_ROLE_KEY`
+- `DATABASE_URL` only when applying migrations manually
+
+Apply migrations:
+
+```bash
+DATABASE_URL='postgresql://postgres:password@host:5432/postgres' sh ./scripts/apply-migrations.sh
+```
+
+Start:
+
+```bash
+docker compose up -d --build
+```
+
+## Coolify
+
+For a no-external-service install, choose Docker Compose deployment and set the compose file to `docker-compose.full.yml`.
+
+Set the generated full-stack env values in Coolify's environment variables. Route the app domain to `neta-web:3000`. If you expose Supabase through a second domain, route it to `neta-supabase-proxy:8000` and set `NEXT_PUBLIC_SUPABASE_URL` to that public URL.
+
+## Dokploy
+
+Create a Compose app from this repository. Use `docker-compose.full.yml` for full-stack deployments and paste the generated env values into the environment panel.
+
+Route the Neta domain to `neta-web` port `3000`. Route the bundled Supabase API domain, if used, to `neta-supabase-proxy` port `8000`.
+
+## First Admin
+
+Open `/register` after the stack starts. The first registered user becomes the admin, and public registration is locked after that.