Skip to main content

Deploy from GitHub

Connect a GitHub repository for automatic deployments on every push.

Setup​

1. Connect GitHub​

Go to Settings and click Connect GitHub. This authorizes Makofy to access your repositories.

2. Create an app with a repo​

When creating an app in the dashboard:

  1. Click New App
  2. Your GitHub repos will appear in a dropdown
  3. Select a repo and branch
  4. Click Create

3. Auto-deploy on push​

Once connected, every push to the configured branch triggers a new deploy automatically. A webhook is set up on your GitHub repo.

How it works​

  1. You push code to GitHub
  2. GitHub sends a webhook to Makofy
  3. Makofy clones your repo, detects the project type, and builds an image
  4. The new image is deployed to your namespace
  5. Previous deploy is marked as superseded

Private repositories​

Private repos require GitHub authentication. When you connect GitHub in Settings, Makofy stores your access token securely (encrypted at rest) and uses it to clone private repos during builds.

Branch configuration​

Each app is configured to track a single branch (default: main). You can change this in the app settings.

Manual deploy​

You can also trigger a deploy manually from the dashboard by clicking the Deploy button on your app's page, or from the CLI:

makofy deploy

When using the CLI, the source is uploaded directly — it doesn't go through GitHub.