CapRover

CapRover

  • Docs
  • GitHub
  • Slack Group

›Help

Basics

  • Getting Started
  • CaptainDuckDuck Upgrade
  • Captain Definition File
  • Deployment Methods
  • App Configuration
  • Persistent Apps
  • CLI Commands
  • One-Click Apps
  • Complete Webapp Tutorial

Do More

  • Resource Monitoring
  • NGINX Config
  • Service Update Override
  • App Scaling & Cluster
  • Pre-deploy Script
  • Play with CapRover
  • Run Locally
  • Certbot Overrides
  • Custom Themes

Recipes and Tips

  • Sample Apps
  • Zero Downtime
  • Database Connection
  • Best Practices
  • Backup & Restore
  • Static React App
  • Stateless with Persistent data
  • Docker Compose
  • CI/CD Integration

    • Intro
    • Deploy from GitHub
    • Deploy from GitLab

Help

    Server Purchase

    • DigitalOcean
    • OpenStack
  • Disk Clean-Up
  • Firewall & Port Forwarding
  • Troubleshooting
  • Troubleshooting (Pro)
  • Help and Support
Edit

Troubleshooting CapRover Pro


This section is only applicable to CapRover Pro subscribers (paid plans). You can subscribe to paid plans and benefit from additional features such as build status notifications, security upgrades such as login alerts and two factor authentication.

Reset OTP (two factor auth)

You may need to reset the two factor authentication in rare cases such as:

  • When https://pro.caprover.com is down and you cannot access your instance
  • When you have lost access to the authenticator app

In these cases, all you need to do is to simply clear the pro configs and temporarily downgrade your server to a non-paid version. You can do that by removing the pro content in /captain/data/config-captain.json

The following helper script will do exactly that:

docker service scale captain-captain=0 && \
docker run -it --rm -v /captain:/captain  caprover/caprover /bin/sh -c "wget https://raw.githubusercontent.com/caprover/caprover/master/dev-scripts/clear-pro-config.js ; node clear-pro-config.js ;" && \
docker service scale captain-captain=1 && \
echo "OKAY"

Update:

Starting v1.12.0, you can run the following script:

docker exec -it $(docker ps --filter name=captain-captain -q) npm run disable-otp

Deploy with OTP enabled

When you have OTP enabled, you cannot deploy using regular caprover deploy as it requires 2FA token (enter OTP token as well). Instead, you should use App Tokens:

caprover deploy --caproverUrl https://captain.domain.com --appToken 123456123456123456 --appName my-app -b main

You can enable App Token from Deployment tab. Alternatively, you can use the following format (not recommended):

CAPROVER_OTP_TOKEN=123456; caprover login

## or

CAPROVER_OTP_TOKEN=123456; caprover deploy

Set specific email address for the alerts

Changing notification emails is not currently a built in feature. However, one of the many reasons that Google was chosen to be our auth provider is that on Gmail you can easily set up filters and forward specific emails to a different email address.

Just search for from: alerts@mail.pro.caprover.com and create a filter, then forward your results to another email address.

gmail-instruction-1 gmail-instruction-2

Email support

Our paid Pro plan includes a 24hr SLA email support. You can email us at pro.support at/caprover/dot/com to get support. Please be sure to use the same email that you've used for purchase.

← TroubleshootingHelp and Support →
  • Reset OTP (two factor auth)
  • Deploy with OTP enabled
  • Set specific email address for the alerts
  • Email support
CapRover
Docs
Getting Started
Community
TwitterSlack Group
More
GitHubStar
Copyright © 2025 githubsaturn