Integration · Deploys and install

Deploy from GitHub to your own server

Opservo deploys your app when you push to a GitHub branch, or when CI calls the deploy endpoint with a token. Runs only where remote actions are on.

In short

Opservo can deploy an app on your server when you push to a chosen GitHub branch. You set the deploy command, an optional rollback command and a health URL once; a signed GitHub webhook then triggers the deploy, and pushes to other branches are ignored. CI can also start a deploy with a workspace API token. Deploys run only on servers where remote actions are switched on.

What you get

Push to the branch and the server deploys, with a release history and a rollback.

  • Push-to-deploy: the GitHub webhook is checked against its secret before anything runs.
  • A deploy command, an optional rollback command and a health check URL with a timeout.
  • POST /api/v1/agents/<id>/deploy from CI with a token that has the deploy scope; an optional commit or tag ref.
  • Release history with status and logs, and a one-click rollback.

How to set it up

Configure the deploy on the server’s page, then connect the repository.

  1. Turn on remote actions for the server (owners and admins only; it is off by default).
  2. On the server’s deploy settings, enter the deploy command, rollback command, health URL, repository and branch, and switch on auto-deploy.
  3. Add the webhook to the GitHub repository, or call the deploy endpoint from your CI with an API token.

Good to know

  • A token-triggered deploy does nothing on a server where remote actions are off.
  • Secrets can be pulled from Infisical at deploy time instead of living on disk.

GitHub deploys and Opservo, answered

Can Opservo deploy my app when I push to GitHub?+

Yes. Configure a deploy command and branch for the server, add the GitHub webhook, and each push to that branch starts a deploy. Pushes to other branches are ignored.

Can a leaked webhook URL run commands on my server?+

The webhook is verified against its secret before anything runs, and it can only start the deploy you configured, on a server where you switched remote actions on.

Read next

Free for 2 servers, no card. Install the agent in about 30 seconds, then connect GitHub deploys.