Quick Start
Get Bunship running locally with app, admin, and docs in one deployment model.
Prerequisites
Install Git
git --versionQuick Installation
Get source code
git clone <your-repo-url> bunship
cd bunshipDownload ZIP, extract it, and open the project root in your terminal.
Install dependencies
bun installpnpm installConfigure environment variables
cp .env.example .envMinimum required variables:
DATABASE_URLBETTER_AUTH_SECRETSITE_URL
.env.example is the local/Web/API runtime template, not the Docker build variable list. The minimal Docker build inputs are documented in the deployment guide.
Initialize database
bun run db:generate
bun run db:deployStart development server
bun run devDefault URLs:
http://localhost:3001/enhttp://localhost:3001/en/adminhttp://localhost:3001/en/docs
Tip
For the fastest validation, run this flow first: signup -> wallet -> subscription -> AI generation -> admin check.