Deploy from an image

The fastest way to run something on BitsReef is to point it at a container image.

From the dashboard

1. Open your project’s canvas and click Add Service.
2. Give it a Service Name.
3. Source Type: Container Image.
4. Image: the image reference, e.g. nginx:latest or ghcr.io/org/app:sha.
5. Set the Exposed Port your container listens on. Optionally tune the restart policy, CPU/memory limits, replica range, health check path, and SSL.
6. Click Create Service.

After the first deploy you can tune everything from the service’s tabs — Environment, Scaling, Domains, and more.

Redeploying

To ship a new version, edit the service’s image to the new tag in its Config and Deploy again. BitsReef performs a rolling update.

From a private registry

To pull from a private registry, add its credentials first:

1. Open Registries from the top nav and click Add registry.
2. Enter the registry URL, username, and access token.
3. Back on the service, reference the private image normally — BitsReef authenticates using the stored credentials.

Scaling, restarting, stopping

From the service’s Scaling tab (or its controls) you can change the replica count, restart, or stop it. See Autoscaling.

From the CLI

# Create-or-update and deploy in one shot:
bitsreef up --project my-project --name web --image nginx:latest --port 80 --follow

# Extra options:
bitsreef up -p my-project -n web -i my/app:tag \
  --env KEY=VALUE --replicas 2 --cpu 0.5 --memory 512 --follow

# Lifecycle:
bitsreef services scale web -r 3
bitsreef services restart web
bitsreef services stop web

See also

• Deploy from Git
• Environment & secrets
• Autoscaling