Using Konduit
Prerequisites
- Your organization has a Git account associated (GitHub App or GitLab) — Konduit prompts you if not
- The platform administrator has enabled Konduit
Projects and environments
- Open Konduit in the sidebar — each project maps to one of your organizations
- Select a project to open the split view: the app rail on the left, app detail on the right
Every project starts with a production environment. Use the environment switcher in the header to create more:
- Names are lowercase alphanumeric with hyphens, up to 18 characters
- production cannot be deleted
- An environment must be empty (no apps) before it can be deleted
Register an app
- Click Register app
- Pick a repository from your connected Git account
- Set the app name, region (target cluster), port (default 8080), and replicas
- Add environment variables if the app needs them (
DATABASE_URL, etc.) - Toggle public URL to expose the app on
https://<app>-<org>.<region>.<domain> - Deploy
Konduit builds the repository with Cloud Native Buildpacks — no Dockerfile required for common stacks (Go, Node.js, Java, Python, Procfile).
Phases
| Phase | Meaning |
|---|---|
| Building | kpack is building the image from your repository |
| Pushing | Image is being pushed to the registry |
| Deploying | The GitOps commit is syncing to the target cluster |
| Live / Online | The app is running; the public URL is active |
| Failed | Terminal error — check the Logs tab for the build output |
| Paused | The organization is suspended; apps are scaled to zero |
App detail tabs
- Overview — public URL, region, replicas, and the latest deployment (image digest, trigger, deployer)
- Variables — edit environment variables (triggers a redeploy)
- Metrics — CPU, memory, pods, and restarts
- Logs — the live build log stream
- Settings — source repository and branch, networking (public URL), scale (replicas), builder info, and the Danger zone: Remove app deletes the app, its build pipeline, and its GitOps manifest
Continuous deployment
Push to the tracked branch and Konduit rebuilds and redeploys automatically. Use Redeploy to force a fresh build from the branch HEAD at any time.