Deploy an app
You’ll run your container image in an environment on a connected cluster.
Before you start
- A connected cluster
- An environment (create under Manage environments if needed)
- A container image Xooshe can pull — use a private registry when the image is not public
Open New App
- Select the target cluster.
- Click New App.
- Choose the app type that matches your workload (for example a stateless service).
Set image and resources
- Enter image name and tag.
- Fill general information (name and required fields).
- On resources:
- Select the environment
- Set copies (how many instances should stay running)
- Set CPU, memory, and disk / storage if the app needs persistence
- Optionally enable a public URL / domain if users should reach the app from the internet (cluster settings and DNS must be ready).
- Confirm and deploy.
You’re done when
- The app appears under the selected environment and status is healthy / running.
- Instances match the number of copies.
- If you set a public URL, it opens in a browser.
If it fails
| Symptom | Fix |
|---|---|
| Image pull errors | Check image path, tag, and registry credentials |
| Stuck creating | Confirm the environment exists and the cluster is reachable |
| Public URL fails | Confirm DNS and cluster public URL / TLS settings |