1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
OneDev
Development1024MB+ RAM
Self-hosted Git server with CI/CD and kanban
gitci-cdkanban
Deploy OneDev in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select OneDev
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy OneDev on a VPS with Server Compass
Use the OneDev template in Server Compass to deploy a self-hosted Git server with CI/CD on your VPS, then verify the OneDev setup screen in a browser.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for OneDev
Use the template picker search to find OneDev in the Server Compass template catalog.
4
Step 4Select the OneDev template
Choose the OneDev template. Server Compass fills the OneDev service, persistent data volume, web port, and Git SSH port.
5
Step 5Review the OneDev settings
Confirm the app name and compose services. In this run, the app was named onedev-demo and used host port 6610.
6
Step 6Deploy OneDev
Review the generated compose settings, confirm the web and SSH ports are available, and click Deploy Now.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the OneDev image, starts the container, and verifies the stack.
8
Step 8Confirm OneDev is running
After deployment finishes, return to the Apps tab and confirm the OneDev app is marked Running with its application URL available.
9
Step 9Open OneDev in the browser
Click Open Application or open the application URL in a browser. The OneDev setup screen confirms the Git and CI/CD server is reachable and ready for final setup.
After OneDev Opens
- Complete the OneDev installation wizard and create the first administrator account.
- Store the administrator credentials and any CI/CD secrets in a secure password manager.
- Add a domain and HTTPS before inviting users or pushing repositories over the public internet.
- Configure Git SSH, build agents, credentials, and job permissions before using OneDev for production CI/CD.
- Back up the OneDev data volume before relying on it for production repositories and jobs.
Verified Result
The OneDev app loaded successfully in a browser and displayed the first-run setup screen.
OneDev deployment questions
What does the OneDev template deploy?
It deploys the OneDev server container with a persistent data volume, web access on port 6610, Git SSH access on port 6611, and Docker socket access for CI/CD workloads.
Which port did the tutorial use?
The tutorial used host port 6610, which maps to the OneDev web UI on container port 6610.
Why does the browser verification stop at the setup screen?
A fresh OneDev deployment is considered reachable when the first-run setup screen loads. Completing setup creates real administrator credentials, so the public guide stops before account creation.
Should this become a blog post?
No. The deployment guide should live on the OneDev template detail page and be linked from the reusable template deployment docs page.
DIY Deployment
Self-Host OneDev with Docker
Take the DIY route and deploy OneDev on your own server using Docker.
1
Remote into Your Server
Initiate a secure shell connection to your server using the command below.
terminal
# Connect to your VPS
ssh root@your-server-ip
# Or with a specific SSH key
ssh -i ~/.ssh/your-key root@your-server-ipFirst time? Docker required! Install it with: curl -fsSL https://get.docker.com | sh
2
Create the App Directory
Organize your deployment by creating a dedicated project folder.
terminal
# Create and navigate to project directory
mkdir -p ~/apps/onedev
cd ~/apps/onedev3
Write Your docker-compose.yml
Create a new docker-compose.yml file and paste this configuration:
docker-compose.yml
services:
onedev:
image: 1dev/server:latest
ports:
- "6610:6610"
- "6611:6611"
volumes:
- onedev_data:/opt/onedev
- /var/run/docker.sock:/var/run/docker.sock
restart: unless-stopped
volumes:
onedev_data:
Configurable Options
PORTWeb port(default: 6610)SSH_PORTSSH port(default: 6611)4
Launch the Containers
Start the services and tail the logs to verify startup.
terminal
# Spin up containers
docker compose up -d
# Verify deployment
docker compose ps
# Check logs for errors
docker compose logs -f5
Open Firewall Ports
Open the required port in your firewall to allow access.
terminal
# Allow the application port through firewall
sudo ufw allow 6610/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:6610Skip the Terminal
Want the easy way? Try Server Compass.
Forget SSH and YAML files. Deploy OneDev visually with Server Compass in just a few clicks.
- Visual config editor
- Instant deployment
- Automatic HTTPS
- Smooth updates
- Live monitoring
- Quick rollbacks
Download Server Compass$29 one-time • Lifetime license
After Deployment
After deploying OneDev with Server Compass, complete these steps to finish setup
1
Create admin account
2
Create projects
3
Configure CI/CD
Need help? Check out our documentation for detailed guides.
OneDev FAQ
Common questions about self-hosting OneDev
How do I deploy OneDev with Server Compass?
Simply download Server Compass, connect to your VPS, and select OneDev from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for OneDev?
OneDev requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing OneDev data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard OneDev backup and restore procedures.
How do I update OneDev to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest OneDev image will be pulled and deployed with zero downtime.
Is OneDev free to self-host?
OneDev is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Related Templates
View all Development
PocketBase
Open-source backend in a single file with realtime database, auth, and file storage
Appwrite
Open-source backend-as-a-service - self-hosted Firebase alternative
Parse Server
Open-source backend framework with dashboard
Supabase
Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio
Ready to Self-Host OneDev?
Download Server Compass and deploy OneDev to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass