Skip to main content

Requirements

  • Bun 1.3+ installed locally
  • Account on Vertra Cloud
  • Configured package.json

Project Structure

Configuration

package.json

bunfig.toml

vertracloud.config

Example: Simple Server with Bun.serve()

src/index.ts

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 (Bun), the main file (index.ts) 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

  • Performance: Bun is significantly faster than Node.js
  • Native TypeScript: Bun runs TypeScript directly without compilation
  • Compatibility: Bun is compatible with Node.js/npm, but has some differences
  • Environment variables: Access via process.env.KEY
  • Logs: Use console.log() for logs that appear in dashboard
  • Modules: Use bun add to add dependencies
  • Listen on 0.0.0.0 on port $PORT
Last modified on November 1, 2026