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

For a local agent on Forgejo, Connect Your AI Agent covers the default single-token MCP + Git setup and setup_project preview/confirm. Clone URLs stay unchanged; pushing requires the Read + deploy + push code access level.

  1. Connect a repo. The built-in Forgejo instance is the default and recommended provider — zero setup, ready to push to immediately. GitHub is in beta: connect it manually through the CompactHive GitHub App, then use Settings → "Set Up" to configure CI for a chosen repository. See the Git Providers page in Guides & Reference for the detail and current GitHub-beta 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.

No comments to display