Self-host Featul

Run your own Featul instance using the open-source repository.

TFTeam FeatulUpdated Oct 241 min read

Featul is open source under the MIT License, which means you can clone the repository and run the full application on your own infrastructure.

Requirements

Before you start, make sure you have:

  • Node.js 20 or later

  • Bun 1.2 or later

  • A PostgreSQL database

  • Environment variables configured for both the app and web sites

Quick start

  1. Clone the usefeatul/featul repository from GitHub.

  2. Install dependencies: bun install

  3. Copy the environment examples:

  • cp apps/app/.env.example apps/app/.env.local

  • cp apps/web/.env.example apps/web/.env.local

  1. Fill in the required environment variables.

  2. Run database migrations.

  3. Start the development server: bun dev

See the repository README for the full production setup.

Tech stack

  • Apps – Next.js and React

  • API – Hono with type-safe RPC (jstack)

  • Database – PostgreSQL with Drizzle ORM

  • Auth – Better Auth (email, Google, GitHub, passkeys, 2FA)

  • Monorepo – Turborepo

  • Editor – Tiptap

  • Runtime – Bun

License

The MIT License permits commercial use, modification, distribution, and private or public deployment.

Was this helpful?

Still stuck?

Post it on the board. The team answers there.