Provision a container

Simple mode provisions a single public container from the control panel. DollarBox creates the Kubernetes Deployment, IPv6 LoadBalancer Service, network policy, and billing item for you.

Before you start

You need:

Billing set up for the org.
At least one available subscribed dollarbox of capacity.
A public Linux image that can run as a non-root user.
An app that listens on TCP port 80. Simple mode publishes port 80.

1. Open the new container form

If the control panel sends you to billing, add or update your payment method first.

2. Name the container

Enter a name using lowercase letters, numbers, and hyphens. The name must be unique inside your org.

Examples:

web
api
docs-preview

The name becomes part of the Kubernetes resource name. If you rename a live container later, DollarBox recreates the Kubernetes resources and assigns a new IPv6 address.

3. Enter the image reference

Use a public image reference such as:

nginx:1.25-alpine
ghcr.io/your-user/your-app:v1.2.3
quay.io/your-org/your-app:stable

Pin a version tag or digest when you care about reproducible deploys. latest works, but it can change without warning.

4. Add configuration

Add environment variables for ordinary config values.

Add secrets for values that should not be shown again in the UI. Secrets are write-only: you can set or replace them, but existing values are not displayed.

5. Create the container

Click Create container. The container appears in the list as Pending or Provisioning while the background task creates the workload and waits for an IPv6 address.

Open the container detail page when it reaches Running. The detail page shows:

The applied image.
The public IPv6 address.
Current status.
Environment status.
Pod state and recent logs when available.

6. Test reachability

If the app speaks HTTP on port 80, test the assigned IPv6 address with brackets:

curl -6 http://[2a01:4f8:c2c:1234::5]/

Replace the example address with the address from the container detail page.

If you want a hostname, create an AAAA record pointing at the IPv6 address.

Updating a container

Open the container and click Edit container. You can change the name, image, environment variables, and secrets.

Saved changes do not affect the running pod until restart. Use Save & restart from the edit screen when available, or use Restart container on the detail page.

Renaming recreates the container resources and gives the container a new IPv6 address. Update DNS after a rename.

Deleting a container

Use Delete from the list or detail page. Deleting removes the workload and removes the billing item. Capacity is released after the container is marked deleted.