Skip to main content
Nudgra OSS is the self-hosted distribution of Nudgra. You run the app server, Postgres database, OAuth routes, Meta webhooks, background jobs, HTTPS, and backups yourself. Use this distribution when you want ownership over infrastructure and data.

View Nudgra OSS on GitHub

Open the self-hosted source repository.

​
Stack

  • TanStack Start.
  • Better Auth.
  • Hono.
  • Drizzle.
  • pg-boss.
  • Postgres.
  • Docker and Caddy for the recommended production deployment.

​
What you need

For local development:
  • Git.
  • Node.js 24 or newer.
  • Docker, or another Postgres database.
  • A Google account.
  • A Meta Developer account.
  • An Instagram professional account.
For production:
  • A VPS.
  • A domain or subdomain.
  • Docker.
  • HTTPS through Caddy or another reverse proxy.

​
Important URLs

Replace https://your-domain.com with your production domain.
PurposeURL
Apphttps://your-domain.com
Health checkhttps://your-domain.com/api/v1/health
Google OAuth redirect URIhttps://your-domain.com/api/auth/callback/google
Meta OAuth redirect URIhttps://your-domain.com/api/meta/callback
Meta webhook callback URLhttps://your-domain.com/api/meta/webhooks

​
Setup path

  1. Run local development.
  2. Configure environment variables.
  3. Configure Google OAuth.
  4. Configure Meta / Instagram setup.
  5. Deploy to a VPS with Docker Compose and Caddy.