page:guides:sinatra:build and start

Configure build and start for Sinatra

Summary

Build and start for a Sinatra app on Ample. Verified on Sinatra: the app built and started with the documented commands and answered on its public HTTPS URL. Build and start: bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template.

Prerequisites

A Sinatra project (bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template)
An Ample account token with servers:write

Workflow Steps

Build and start
bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template; the server must bind 0.0.0.0 on PORT.
Deploy
Run the synchronous deploy once and read the result.
ample deploy . --name --public
Verify
Fetch the live URL on the example; on failure read the build and runtime logs.
ample logs --kind build

Tested Configuration

Template: ruby-3.4
Runtime: ruby
Size: s-1vcpu-1gb
Install Command: bundle config set --local path vendor/bundle && bundle config set --local without 'development test' && bundle install
Start Command: bundle exec rackup -o 0.0.0.0 -p $PORT

Limitations

Verified on the ruby-3.4 template at s-1vcpu-1gb; other sizes and Sinatra major versions are not verified.
Region, compliance attestations and request-duration limits are unknown and not claimed.

Cost Estimate

Currency: USD
Monthly Amount: 5.0
Basis: size prices from pricing.toml (loaded by the API) at build revision 1ac5595375130d45290090e82ed0f554ccd45405-dirty
Components:
- Name: app server
- Size: s-1vcpu-1gb
- Quantity: 1.0
- Monthly Amount: 5.0
Note: Always-on monthly price of the tested sizes; apps auto-pause when idle.

Examples

Title: Sinatra pattern fixture
Description: Verified build and start on Sinatra.
Source Reference: tests/deploy-canaries/sinatra-patterns

Success Checks

Description: app responds on its public URL
Kind: http_get
Path: /
Expect: ample canary sinatra patterns

Evidence Summary

Kind: canary_run
Summary: Sinatra pattern fixture deployed on Ample (bundle install into vendor/bundle from Gemfile.lock (development and test groups skipped), then Puma via rackup (config.ru) reading PORT on the ruby-3.4 template); for this guide: the app built and started with the documented commands and answered on its public HTTPS URL.
Observed At: 2026-09-20T23:45:31Z
Implementation Revision: 4d1511e574302f3904b75088bd4048a0975218b3-dirty (CLI 0.1.21)
Expires At: 2027-03-19T23:45:31Z

Last Verified At

2026-09-20T23:45:31Z