Deploy from Gitea & Forgejo
Connect a self-hosted Gitea, Forgejo or Codeberg account with an access token and deploy private repositories through the Stack Wizard. Server Compass uploads the SSH key, picks up a custom SSH port, and supports LAN instances over HTTP with an explicit opt-in.

Deploy from Gitea & Forgejo Walkthrough
Deploy from Gitea & Forgejo replaces complex workflows with a few clicks. Here's the process.
Choose Gitea / Forgejo
In a server’s Git tab choose Add New, then Gitea / Forgejo. The same form is on the Git page and behind Add Gitea / Forgejo account in Server Settings.
Enter the address you open in the browser
Instance URL takes the web root with any port or sub-path, such as http://10.0.1.78:3000, and no /api/v1. An http:// address keeps Connect account disabled until you tick Allow HTTP for this account.
Paste a token and keep the SSH key option
The token needs user: Read and write and repository: Read, plus organization: Read for organization repositories. A token missing one is refused with the permission named. Generate and upload an SSH key adds a key from your server to the account.
Deploy from the Stack Wizard
Pick the account, repository and branch. The SSH port is read from the repository’s clone address before each deploy, so an instance on 2222 needs no setup, and a redeploy pulls new commits through the same account.
Doing It Manually Without Deploy from Gitea & Forgejo
Think Deploy from Gitea & Forgejo is overkill? Here's the alternative: raw terminal commands and manual config files.
Generate a deploy key on the server
The server needs its own key to read your private repositories.
ssh root@your-server-ip
ssh-keygen -t ed25519 -f ~/.ssh/gitea_deploy -N ""
cat ~/.ssh/gitea_deploy.pubAdd the key to your Gitea account
Paste it into Gitea by hand, or upload it through the API with a token that has write:user.
# Avatar > Settings > SSH / GPG Keys > Add Key
# or through the API:
curl -X POST https://git.example.com/api/v1/user/keys \
-H "Authorization: token $GITEA_TOKEN" \
-H "Content-Type: application/json" \
-d "{\"title\":\"vps\",\"key\":\"$(cat ~/.ssh/gitea_deploy.pub)\"}"Write a Host block for the SSH port
Gitea and Forgejo in containers usually serve SSH on 2222, so Git needs to be told the port and the key.
cat >> ~/.ssh/config <<'EOF'
Host gitea-home
HostName git.example.com
Port 2222
User git
IdentityFile ~/.ssh/gitea_deploy
IdentitiesOnly yes
EOF
ssh -T gitea-homeLeave the Port line out and Git tries port 22, where the host’s own SSH server rejects the key.
Clone, build, and repeat for every update
Clone through the alias and build the stack by hand.
git clone gitea-home:owner/app.git /opt/apps/app
cd /opt/apps/app && docker compose up -d --build
# every new commit:
git pull && docker compose up -d --buildEvery update means another SSH session, pull and rebuild, and a second account needs its own key and Host block.
Let Server Compass Handle It
Deploy from Gitea & Forgejo automates the tedious parts. What takes 30 minutes via terminal takes 30 seconds with Server Compass.
- Visual interface
- No terminal needed
- Built-in error handling
- Works on any VPS
Deploy from Gitea & Forgejo Capabilities
Everything you need for deployment in one integrated tool, replacing complex CLI commands and manual configuration.
Get StartedWhy Deploy from Gitea & Forgejo Matters
Server management shouldn't require a DevOps team. Deploy from Gitea & Forgejo makes professional-grade deployment accessible to everyone.
Deploy in Minutes
Deploy from Gitea & Forgejo eliminates complex CLI workflows. Deploy your applications visually without memorizing Docker commands.
Zero-Configuration Defaults
Deploy from Gitea & Forgejo comes pre-configured with production-ready settings so you can ship with confidence.
Visual Feedback
Track every step of your deployment with Deploy from Gitea & Forgejo. See progress, logs, and status in real time.
Repeatable Process
Once configured, Deploy from Gitea & Forgejo lets you replicate deployments across servers consistently.
Common Questions About Deploy from Gitea & Forgejo
Common questions about Deploy from Gitea & Forgejo in Server Compass
How do I access Deploy from Gitea & Forgejo in Server Compass?
Deploy from Gitea & Forgejo is available in the Deployment section of Server Compass. Simply connect to your server, navigate to Deployment, and you'll find Deploy from Gitea & Forgejo ready to use. No additional setup or plugins required.
Does Deploy from Gitea & Forgejo require any server-side installation?
No. Server Compass operates as a desktop application that connects to your server via SSH. Deploy from Gitea & Forgejo works through this connection without installing any agents or packages on your server (except the optional monitoring agent for resource tracking).
Is Deploy from Gitea & Forgejo included in all Server Compass plans?
Yes. Every Server Compass feature, including Deploy from Gitea & Forgejo, is included with the one-time $29 payment. There are no tier restrictions, add-ons, or per-server fees. You get all 157+ features for all your servers.
Can I use Deploy from Gitea & Forgejo with any VPS provider?
Deploy from Gitea & Forgejo 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 Deploy from Gitea & Forgejo different from command-line alternatives?
Deploy from Gitea & Forgejo 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 Deployment Features
Explore other deployment capabilities in Server Compass
Docker Stack Wizard
Multi-step wizard walks you through deploying containerized applications. Choose source, configure settings, and deploy in minutes.
Template-Based Deployment
Choose from 100+ pre-built templates for databases, services, and development tools. Deploy popular stacks with one click.
Deploy from GitHub
Deploy directly from any GitHub repository. Select branches, configure build settings, and ship your code to production.
Docker Compose Editor
Full-featured YAML editor for docker-compose configurations. Write, edit, and validate your compose files visually.
Try Deploy from Gitea & Forgejo Today
Download Server Compass and get access to Deploy from Gitea & Forgejo along with 156 other features. One-time $29 payment. No subscriptions. No per-server fees.