Skip to main content
Your app runs on a scalable, serverless backend. It can handle millions of function calls per day, and run events at scheduled times.
Hosting page showing the Production deployment with hosting region, HTTP Actions URL, backups and backend analytics, and a branch deployment under Development deployments

​
What can the backend do?

  • API routes: Handle requests from your frontend
  • Database access: Query and update your data
  • Scheduled functions: Run functions at a specific times
  • Cron jobs: Run functions on a recurring schedule
  • Public API: Expose endpoints that other apps can call to query your data

​
How do I view backend activity?

Open the Hosting tab to see your deployments. Each deployment’s row shows:
  • Backend analytics: Click View to see call counts, database bandwidth, and compute for each backend function, including functions your cron jobs and scheduled functions run
  • Backups: Your backup schedule. Click it to see or schedule backups of your data
The Hosting tab doesn’t list cron jobs or scheduled functions. Cron jobs are defined in convex/crons.ts. To check them, or to see backend logs and errors, ask Hercules.

​
How does it scale?

The backend is serverless meaning it can scale up and scale down as needed. This means it’s cheap and fast.

​
How do I move my app to another region?

Move an app’s backend and database to another region, such as from the US to Europe or Australia. Only that app moves. Your other apps, and the default region for new apps, stay the same.
  1. Open the app and go to Publish → Hosting in the Sidebar.
  2. On the Production row, click the hosting region.
  3. Pick a region and click Change region.
Change region dialog with EU West (Ireland) selected
Your app is offline during the move, usually for a few minutes. Scheduled tasks that haven’t run yet are not moved.
The Production row shows Changing region until the move finishes. Your old copy stays on the Hosting screen as Old production, paused so its scheduled tasks stop. To check old data, click ⋮ → Resume. Once you no longer need it, click ⋮ → Delete. To move a development deployment, click its hosting region under Development deployments, pick a region, and click Change region. Only that deployment moves, and it is offline until the move finishes. Publishing waits until then, and each app moves one deployment at a time. The old copy stays paused, named after the deployment with Old in front. Hercules pushes your latest backend code to the moved deployment the next time your preview uses it.
Change region dialog for a development deployment with EU West (Ireland) selected
Changing a region needs the Business plan, and only organization owners and admins can do it. To set the region for new apps, go to Settings → Data → Data residency.
The Hercules backend uses the following public IP addresses:US East (N. Virginia)
  • IPv4: 216.235.222.0/24
  • IPv6: 2600:1f18:77e:2300::/56, 2600:1f10:4a09:7c00::/56
EU West (Ireland)
  • IPv4: 3.248.173.188, 34.242.144.108, 54.170.181.63, 54.195.47.143, 54.73.189.39, 63.33.186.66
  • IPv6: 2a05:d018:6f:e900::/56, 2a05:d018:3aa:3c00::/56
Canada Central (Montreal)
  • IPv4: 3.97.235.161, 3.98.180.27, 3.98.212.39, 15.222.189.58, 16.54.252.217, 52.60.206.62
  • IPv6: 2600:1f11:8:ea00::/56, 2600:1f11:56e:300::/56
Asia Pacific (Sydney)
  • IPv4: 13.238.177.157, 16.178.19.224, 52.62.9.39, 52.62.114.123, 52.65.179.161, 54.66.89.81
  • IPv6: 2406:da1c:11ea:f700::/56, 2406:da1c:4f4:fd00::/56
No, for security reasons we unfortunately cannot expose access to the Convex deploy key.