cli

deploy

Deploy all services defined in your runix.yaml file.

runix deploy#

Reads the runix.yaml in the current directory and deploys all services defined in it. If any services with matching names already exist, they are automatically replaced.

bash

$ runix deploy
✓ Removed 1 existing deployment(s)
⠋ Deploying services...
Success! 2 service(s) deployed:
  ✓ api
  ✓ db

How It Works#

1.Reads and validates your runix.yaml file
2.Checks for existing deployments with the same service names
3.Removes conflicting deployments automatically (parent services only)
4.Sends the YAML to the Runix API, which provisions all services
5.Returns the deployment IDs for each service

Runix uses AI to automatically detect your runtime and generate an optimized Dockerfile. No Docker knowledge needed.

You must have a runix.yaml in the current directory. If not, run `runix init` first.

Error when runix.yaml is missing

bash

$ runix deploy
Error: No runix.yaml found. Run `runix init` to create one.

Full Deploy Example#

Create your config

bash

runix init

Edit runix.yaml

runix.yaml

yaml

name: my-saas
services:
  - name: backend
    type: web-service
    repo: https://github.com/alice/backend
    branch: main
    instance: standard
    env:
      PORT: "3000"
      DATABASE_URL: "${db.connection_string}"

  - name: db
    type: postgresql

Deploy

bash

$ runix deploy
Success! 2 service(s) deployed:
  ✓ backend
  ✓ db

Check status

bash

runix status

init

status & logs