Skip to main content

Deploying Your App

CompactHive's deploy flow is push-to-deploy: once it's set up, you don't run any deploy commands yourself.

The flow

  1. Connect a repo. In the portal, connect a GitHub or GitLab repository, or use theThe built-in GiteaForgejo instance ifis you'dthe ratherdefault notand bringrecommended yourprovider own.— zero setup, ready to push to immediately. GitHub canis bein connectedbeta: withconnect oneit clickmanually viathrough the CompactHive GitHub App, whichthen auto-detectsuse yourSettings project→ "Set Up" to configure CI for a chosen repository. See the Git Providers page in Guides & Reference for the detail and generatescurrent aGitHub-beta CI pipeline for you.limitations.
  2. Push your code. Your repo needs a Dockerfile describing how to build your app. Push to your default branch (or open a PR, depending on your pipeline config).
  3. CI builds it. Woodpecker CI picks up the push and builds your image using Kaniko (a container-friendly image builder). Registry credentials are auto-injected into the pipeline — there's no manual registry login to configure.
  4. Image goes to your registry. The built image is pushed to your private container registry, tagged with the commit SHA and latest.
  5. Auto-deploy rolls it out. If the app has auto-deploy enabled, the pipeline redeploys it automatically — typically in under a minute from push. Prefer to review a build before it goes live? Turn auto-deploy off and use "Release latest build" in the portal when you're ready.

A live timeline in the portal (Pushed → Built → Deployed → Live) shows exactly where each push is in this pipeline.

App kinds

When you create an app in the portal, you choose a kind:

  • web — a long-running service exposed on a port, with a public URL.
  • cron — a scheduled job that runs on a cron schedule you define.
  • worker — a long-running background process with no public URL.

Where to go for detail

This page is the overview. The Guides & Reference chapter covers CI/CD pipeline internals, app resource limits and per-tier app caps, custom domains, and connecting your own AI coding agent. Once you're signed in, your portal also has a Developer Guide tailored to your tenant — it shows your actual registry URL, app URL pattern, and a pipeline template pre-filled for your setup. That's the reference to use once you're actually wiring up a repo.