Skip to main content

How to use ready-made apps

You’ll deploy a catalog template into an environment, then connect other apps using the endpoints Xooshe shows you.

Before you start​

  • Connected cluster and an environment
  • Permission to create an app (roles); otherwise New App is hidden
  • Domain / TLS ready in cluster settings if you want HTTPS public URLs (cluster settings is owner-only)

Pick a ready-made app​

  1. Select your cluster.
  2. Start a ready-made app from the catalog (New App or the ready-made flow).
  3. Pick the app (Nginx, Grafana, GitLab Runner, PostgreSQL, …).

Browse options in the ready-made catalog. For GitLab CI, see GitLab Runner. For databases, also see Choose a database path.

Configure and deploy​

Configure what the template supports:

  • Environment (required)
  • Access: internal only, or a public URL / domain
  • Disk / storage when the app keeps data
  • Resources and copies when shown
  • Custom configuration after deploy when the app needs a token or job sizing (GitLab Runner, Airbyte)

Confirm and deploy.

You’re done when​

  • The app appears under the selected environment and health / status is running or healthy.
  • If you enabled a public URL, it responds in a browser.
  • Connection details (when the template provides them) are visible on the app detail page.