Skip to main content

Requirements

  • Ruby 3.3+ installed locally
  • Bundler for dependency management
  • Account on Vertra Cloud

Project Structure

Configuration

Gemfile

The platform automatically runs bundle install. Do not include the vendor folder in the upload.

vertracloud.config

Example: Sinatra Application

app.rb

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 (Ruby), the main file (app.rb) 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: Use Bundler to manage gems
  • Environment variables: Access via ENV['KEY']
  • Database: Configure credentials as environment variables
  • Logs: Use puts or STDOUT.puts for logs that appear in dashboard
  • GIL: Ruby uses the Global Interpreter Lock, consider multiple processes for I/O intensive work
  • Listen on 0.0.0.0 on port $PORT
Last modified on November 1, 2026