Skip to main content

Requirements

Project Structure

Configuration

package.json

vertracloud.config

Complete Example

Always use '0.0.0.0' as host in app.listen(). The default localhost binding does not accept external connections inside the container.

Deploy

  1. Compress the project into a .zip (folders like node_modules, venv and target are removed automatically) or push it to GitHub.
  2. In the dashboard, click New Project and upload the .zip or paste the repository URL.
  3. In Build, check the runtime (JavaScript), the main file (index.js) and the memory. Start and build commands are under Advanced settings.
  4. Add your environment variables in Environment.
  5. In Network, turn on web publishing so the app gets a *.vertraweb.app address (512 MB of memory or more). The app must listen on port 80.
  6. Review and deploy. Follow the output in the Logs tab.
The full walkthrough is in First deploy.

Available Versions

Connecting to a Database

Vertra databases require TLS and the client certificate. Put the three files from the database’s Certificates tab in your project and read them when opening the pool:
MongoDB, Redis and MySQL examples are in How do I connect to each engine?.

Notes

  • For TypeScript applications, compile before deployment and point MAIN to the compiled .js file
  • Use environment variables for database configuration and secrets
  • Auto-restart is on by default for every application
  • Configure a /health endpoint for monitoring
Last modified on November 1, 2026