Dokploy Deployment

Dokploy is a self-hosted deployment platform that provides a UI and Git-based deployments on your own servers.

Prerequisites

• Linux VPS with root access
• Docker installed
• A domain name (recommended for HTTPS)
• Git repository access

Install Dokploy

Follow the official Dokploy installation guide. The quick install script is:

curl -sSL https://dokploy.com/install.sh | sh

Make sure ports 80, 443, and 3000 are available before installation.

Create a Project

1. Open the Dokploy dashboard (default: http://your-server-ip:3000)
2. Create a new project
3. Connect your Git repository

Configure Build and Start

For TinyShip, use the following settings:

• Root Directory: apps/next-app or apps/nuxt-app
• Install Command: pnpm install
• Build Command: pnpm run build
• Start Command: pnpm run start:next or pnpm run start:nuxt
• Port: Use the app port configured in your project (default: 7001)

Environment Variables

Add required environment variables in the Dokploy dashboard:

DATABASE_URL="postgresql://..."
BETTER_AUTH_SECRET="your-32-char-secret"
BETTER_AUTH_URL="https://yourdomain.com"

Database and Migrations

Prepare your production database and run migrations:

pnpm db:generate
pnpm db:migrate
pnpm db:check

Deploy and Verify

1. Click Deploy in Dokploy
2. Configure your domain and HTTPS
3. Verify health check endpoint: /api/health

Troubleshooting

If deployment fails, check:

• Build logs in Dokploy dashboard
• Environment variables and database connection
• Port exposure and domain routing
• Health check endpoint accessibility

Back to Deployment Overview