This documentation covers Convox V2, our ECS-based engine. V2 is fully supported and actively maintained. Looking for the Kubernetes-based V3 engine? See docs.convox.com.
start
Start an App for local development. Builds and runs your App locally using Docker, with optional code sync for live reloading. This lets you develop and test against a local environment that mirrors your production Rack setup.
Syntax
$ convox start [service] [service...]
Flags
| Flag | Short | Description |
|---|---|---|
--app |
-a |
App name |
--generation |
-g |
Generation |
--manifest |
-m |
Manifest file |
--no-build |
Skip build | |
--no-cache |
Build without layer cache | |
--no-sync |
Do not sync local changes into running containers | |
--rack |
-r |
Rack name |
--shift |
-s |
Shift local port numbers (generation 1 only) |
Example Usage
$ convox start
build | building: web
build | Step 1/4 : FROM ruby:3.2
build | Step 2/4 : COPY . /app
build | Step 3/4 : WORKDIR /app
build | Step 4/4 : CMD ["bundle", "exec", "rails", "server"]
build | Successfully built a1b2c3d4e5f6
build | running: docker tag abc123 myapp/web
convox | starting sync for web at .
web | [2025-01-15 12:00:00] INFO WEBrick::HTTPServer#start: pid=1 port=3000
web | listening on 0.0.0.0:3000
See Also
