Auto-Deploy on Push
Deploy your app automatically on every push to GitHub — a signed webhook triggers an always-on worker on your server, so the desktop app can stay closed and your SSH port stays private. Route it through Server Compass–managed Traefik, a stable tunnel, or your own reverse proxy — running on the host or inside Docker.
Getting Started with Auto-Deploy on Push
Auto-Deploy on Push is designed to be intuitive. Here's how you use it in Server Compass.
Open Set up Auto Deploy
On a GitHub-connected app that builds on your VPS, open the Deployments tab and click Set up Auto Deploy.
Choose how GitHub reaches you
Enter a public HTTPS hostname and pick a route: managed Traefik, an existing reverse proxy, or a stable Cloudflare Tunnel. SSH stays private.
Activate and connect
A readiness check verifies Docker, Compose, and the gateway port, then Server Compass installs the policy and creates the GitHub webhook for you.
Push and it deploys itself
Every push to your tracked branch sends a signed webhook to an always-on worker that redeploys the exact commit — even with the desktop app closed.
Before Auto-Deploy on Push Existed
This is what you'd have to do manually without Auto-Deploy on Push. We don't recommend it.
Create workflow file
Write GitHub Actions YAML.
# In your repo:
mkdir -p .github/workflows
nano .github/workflows/deploy.yml
# Write ~50 lines of YAML
# name: Deploy
# on:
# push:
# branches: [main]
# jobs:
# deploy:
# runs-on: ubuntu-latest
# steps:
# - uses: actions/checkout@v4
# - name: Deploy via SSH
# uses: appleboy/ssh-action@master
# with:
# host: ${{ secrets.HOST }}
# username: ${{ secrets.USERNAME }}
# key: ${{ secrets.SSH_KEY }}
# script: |
# cd /opt/apps/myapp
# git pull
# docker compose up -d --buildYAML indentation errors? Good luck debugging.
Add secrets
Configure GitHub secrets.
# Go to GitHub repo
# Settings > Secrets and variables > Actions
# Add each secret:
# - HOST
# - USERNAME
# - SSH_KEY (entire private key!)
# One typo = failed deploysTest and debug
Push and watch it fail.
git add .
git commit -m "Add CI/CD"
git push
# Go to Actions tab
# Watch it fail on line 47
# Fix, commit, push, repeatOr... Just Use Server Compass
Auto-Deploy on Push automates the tedious parts. What takes 30 minutes via terminal takes 30 seconds with Server Compass.
- Point and click
- Instant validation
- Safe defaults
- Works with any provider
What Auto-Deploy on Push Can Do
Everything you need for ci/cd & auto-deploy in one integrated tool, replacing complex CLI commands and manual configuration.
Get StartedAuto-Deploy on Push: Why It's Essential
Server management shouldn't require a DevOps team. Auto-Deploy on Push makes professional-grade ci/cd & auto-deploy accessible to everyone.
Automatic Deployments
Auto-Deploy on Push triggers deployments on every code push, keeping your production in sync with your repository.
Build Visibility
Auto-Deploy on Push shows real-time GitHub Actions build logs so you debug failures without leaving the app.
Safe Rollouts
Auto-Deploy on Push uses health checks to validate new deployments before switching traffic.
Free CI Minutes
Auto-Deploy on Push leverages GitHub Actions for builds, keeping your server resources free for running apps.
Questions About Auto-Deploy on Push
Common questions about Auto-Deploy on Push in Server Compass
How do I access Auto-Deploy on Push in Server Compass?
Auto-Deploy on Push is available in the CI/CD & Auto-Deploy section of Server Compass. Simply connect to your server, navigate to CI/CD & Auto-Deploy, and you'll find Auto-Deploy on Push ready to use. No additional setup or plugins required.
Does Auto-Deploy on Push require any server-side installation?
No. Server Compass operates as a desktop application that connects to your server via SSH. Auto-Deploy on Push works through this connection without installing any agents or packages on your server (except the optional monitoring agent for resource tracking).
Is Auto-Deploy on Push included in all Server Compass plans?
Yes. Every Server Compass feature, including Auto-Deploy on Push, is included with the one-time $29 payment. There are no tier restrictions, add-ons, or per-server fees. You get all 132+ features for all your servers.
Can I use Auto-Deploy on Push with any VPS provider?
Auto-Deploy on Push works with any VPS or dedicated server that supports SSH access and Docker. This includes DigitalOcean, Hetzner, Vultr, Linode, AWS EC2, Google Cloud, Azure, and any other provider. It also works with local servers and homelab setups.
What makes Auto-Deploy on Push different from command-line alternatives?
Auto-Deploy on Push provides a visual, intuitive interface that replaces complex CLI commands and configuration files. You get real-time feedback, safety confirmations, and a consistent experience across all your servers without memorizing syntax or writing scripts.
More CI/CD & Auto-Deploy Features
Explore other ci/cd & auto-deploy capabilities in Server Compass
GitHub Actions Integration
Build and deploy using GitHub Actions free CI minutes. Your server resources stay free for running apps.
Workflow Management
Sync, view, and manage GitHub Actions workflows. See run history, job status, and trigger workflows manually.
Build Job Logs
View real-time GitHub Actions build logs. Debug failed builds without leaving the Server Compass app.
Try Auto-Deploy on Push Today
Download Server Compass and get access to Auto-Deploy on Push along with 131 other features. One-time $29 payment. No subscriptions. No per-server fees.