Skip to main content

​
Setup

Techulus Cloud integrates with GitHub through a GitHub App. To enable it:
  1. Create a GitHub App and configure it with your control plane URL.
  2. Set the following environment variables on the control plane:
  1. Install the GitHub App on your GitHub account or organization.

​
Connecting a Repository

Once the GitHub App is installed, connect a repository to a service:
  1. Set the service source type to github.
  2. Select the repository from your installed GitHub accounts.
  3. Choose the branch to deploy from (defaults to main).
  4. Optionally set a root directory if your app isn’t at the repository root.

​
Auto-Deploy

When auto-deploy is enabled (the default), pushing to the configured branch triggers a build and deployment automatically. The flow:
  1. GitHub sends a push webhook to the control plane.
  2. The control plane creates a build for the new commit.
  3. An agent claims the build, clones the repository, and builds the image.
  4. On success, a rollout deploys the new image.
GitHub deployment statuses are updated on the commit so you can track progress from pull requests.

​
Build Process

Agents build images using one of two methods:

​
Custom Dockerfile Path

To use a Dockerfile at a different path or with a different name, set a TECHULUS_DOCKERFILE_PATH environment variable on the service, e.g. TECHULUS_DOCKERFILE_PATH=docker/prod.Dockerfile.
  • The path is relative to the build context (the repository root, or the service’s root directory if set).
  • When set, the Dockerfile build method is always used — if the file doesn’t exist, the build fails instead of falling back to Railpack.
Images are built with BuildKit, tagged with the commit SHA, and pushed to the private registry. Build statuses: Build logs stream to Victoria Logs in real time and are viewable from the web UI.