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.
- Turn on remote actions for the server (owners and admins only; it is off by default).
- On the server’s deploy settings, enter the deploy command, rollback command, health URL, repository and branch, and switch on auto-deploy.
- 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.