web/versioned_docs/version-0.21/guides/deployment/caprover.md
import { SecretGeneratorBlock } from "../../project/SecretGeneratorBlock";
This guide shows you how to deploy a Wasp application to Caprover, a self-hosted PaaS (Platform as a Service) for managing your deployments.
Deploying to Caprover involves:
Point your DNS A records to your server IP:
@ (root) → server IP (for myapp.com - client)api → server IP (for api.myapp.com - server):::tip
If you followed Caprover's install instructions with *.apps subdomain setup, you can use https://myapp-client.apps.mydomain.com and https://myapp-server.apps.mydomain.com for quick testing.
:::
myapp-db18 (or whichever version is latest)postgresql://postgres:<password>@srv-captain--myapp-db:5432/postgresmyapp-serverhttps://api.<your-domain>3001myapp-clienthttps://<your-domain>8043In the server app, go to App Configs > Environment Variables and add:
| Variable | Value |
|---|---|
DATABASE_URL | postgresql://postgres:<password>@srv-captain--myapp-db:5432/postgres |
JWT_SECRET | Random string at least 32 characters long: <SecretGeneratorBlock /> |
PORT | 3001 |
WASP_WEB_CLIENT_URL | https://<your-domain> |
WASP_SERVER_URL | https://api.<your-domain> |
Add any other environment variables your app needs (from .env.server).
ghcr.ioCreate .github/workflows/deploy.yml in your repository:
name: "Deploy"
on:
push:
branches:
- "main"
concurrency:
group: deployment
cancel-in-progress: true
env:
WASP_VERSION: "{pinnedLatestWaspVersion}"
SERVER_APP_NAME: "myapp-server"
SERVER_APP_URL: "https://api.myapp.com"
CLIENT_APP_NAME: "myapp-client"
DOCKER_REGISTRY: "ghcr.io"
DOCKER_REGISTRY_USERNAME: ${{ github.repository_owner }}
DOCKER_REGISTRY_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
jobs:
build-and-push-images:
permissions:
contents: read
packages: write
runs-on: ubuntu-latest
# Remove this block if your app is NOT in an 'app' folder
defaults:
run:
working-directory: ./app
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Log in to Container registry
uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ env.DOCKER_REGISTRY_USERNAME }}
password: ${{ env.DOCKER_REGISTRY_PASSWORD }}
- name: (server) Extract metadata for Docker
id: meta-server
uses: docker/metadata-action@v5
with:
images: ${{ env.DOCKER_REGISTRY }}/${{ env.DOCKER_REGISTRY_USERNAME }}/${{ env.SERVER_APP_NAME }}
- name: (client) Extract metadata for Docker
id: meta-client
uses: docker/metadata-action@v5
with:
images: ${{ env.DOCKER_REGISTRY }}/${{ env.DOCKER_REGISTRY_USERNAME }}/${{ env.CLIENT_APP_NAME }}
- name: Setup Node.js
uses: actions/setup-node@v6
with:
node-version: "{minimumNodeJsVersion}"
- name: Install Wasp
shell: bash
run: npm i -g @wasp.sh/wasp-cli@${{ env.WASP_VERSION }}
# Uncomment if using Wasp TS Config
# - name: Initialize Wasp TS Config
# run: wasp ts-setup
- name: Build Wasp app
run: wasp build
- name: (client) Build
run: REACT_APP_API_URL=${{ env.SERVER_APP_URL }} npx vite build
- name: (client) Prepare Dockerfile
run: |
cd ./.wasp/out/web-app
echo "FROM pierrezemb/gostatic" > Dockerfile
echo "CMD [\"-fallback\", \"index.html\", \"-enable-logging\"]" >> Dockerfile
echo "COPY ./build /srv/http" >> Dockerfile
- name: (server) Build and push Docker image
uses: docker/build-push-action@v6
with:
# Remove 'app/' if your app is at the repo root
context: ./app/.wasp/out
file: ./app/.wasp/out/Dockerfile
push: true
tags: ${{ steps.meta-server.outputs.tags }}
labels: ${{ steps.meta-server.outputs.labels }}
- name: (client) Build and push Docker image
uses: docker/build-push-action@v6
with:
# Remove 'app/' if your app is at the repo root
context: ./app/.wasp/out/web-app
file: ./app/.wasp/out/web-app/Dockerfile
push: true
tags: ${{ steps.meta-client.outputs.tags }}
labels: ${{ steps.meta-client.outputs.labels }}
- name: (server) Deploy to Caprover
uses: caprover/[email protected]
with:
server: ${{ secrets.CAPROVER_SERVER }}
app: ${{ env.SERVER_APP_NAME }}
token: ${{ secrets.SERVER_APP_TOKEN }}
image: ${{ steps.meta-server.outputs.tags }}
- name: (client) Deploy to Caprover
uses: caprover/[email protected]
with:
server: ${{ secrets.CAPROVER_SERVER }}
app: ${{ env.CLIENT_APP_NAME }}
token: ${{ secrets.CLIENT_APP_TOKEN }}
image: ${{ steps.meta-client.outputs.tags }}
In your GitHub repository, go to Settings > Secrets and variables > Actions and add:
CAPROVER_SERVERYour Caprover dashboard URL, e.g., https://captain.apps.mydomain.com
SERVER_APP_TOKENCLIENT_APP_TOKENPush to the main branch and the GitHub Action will: