Skip to main content

Requirements

  • Node.js installed locally (for development)
  • Account on Vertra Cloud
  • package.json file at project root

Project Structure

Configuration

package.json

Make sure package.json has a start script defined:
The platform automatically runs npm install before starting your application. Do not include node_modules in the upload.

vertracloud.config (Optional)

Example: Simple HTTP Server

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

Notes

  • Dependencies are automatically installed via npm install
  • Environment variables can be configured in the dashboard or via API
  • Logs are available in real-time in the dashboard terminal
  • Auto-restart is on by default, automatically restarting on crash
  • Always listen on process.env.PORT and on host 0.0.0.0

Common Issues

Make sure all dependencies are listed in package.json. The platform only installs what is declared.
Your application might be trying to use a fixed port. Use process.env.PORT for the correct port.
Check the logs to identify the error. Syntax errors or missing dependencies are common causes. The crash loop detection system will pause auto-restart after 5 crashes in 10 minutes.
Last modified on November 1, 2026