First Deployment
Complete guide to deploying your first infrastructure with Siovos Desktop
This guide walks you through deploying your first infrastructure. The process typically takes 3 to 7 minutes depending on the profile and your server's performance.
Before You Begin#
Make sure you have:
- Siovos Desktop installed (getting started)
- A remote server (VPS) with Debian 13
- Root SSH access to your server
- Your server's IP address
- An SSH private key for authentication
Server resources per profile:
| Profile | Minimum RAM | Disk |
|---|---|---|
| Free | 1 GB | 5 GB |
| Minimal | 2 GB | 10 GB |
| Light / Developer | 2-4 GB | 20 GB |
| Standard | 4-6 GB | 50 GB |
| Complete | 8 GB+ | 100 GB |
See the profiles page for details.
Step 1: Launch the Wizard#
- Open Siovos Desktop
- Click "New Deployment" from the dashboard
- The configuration wizard will launch
Step 2: Server Configuration#
Enter your server details:
- IP Address: Your server's IP (accessible from your machine)
- SSH User: Usually
root - SSH Private Key: Click "Browse" to select your key file
Security: Your SSH key is only used during deployment and is never sent to external servers. It stays encrypted on your local machine.
Test Connection#
Click "Test Connection" to verify Siovos Desktop can reach your server.
If the test fails, see the troubleshooting guide.
Step 3: Choose a Deployment Profile#
Siovos offers pre-configured profiles tailored for different use cases. See the dedicated profiles page for details.
Customize (Optional)#
By clicking "Customize" on a profile, you can:
- Change service passwords
- Add a development database
- Enable/disable optional services
Security tip: Generated passwords are 16 characters long with a mix of letters, numbers, and special characters.
Custom Service Selection (Business)#
Users with a Business license can configure services individually instead of using a predefined profile.
Step 4: Configure Networking#
- Internal domain: Default
.internal(e.g.,rancher.internal) - VPN Network: Default
10.8.0.0/24(usually fine)
Step 5: Deploy#
Review your configuration summary then click "Start Deployment".
The deployment runs automatically. You'll see real-time progress including the current task, completion percentage, and detailed logs.
Important: Stay on the deployment screen during the entire process. Leaving this page interrupts the deployment.
The first deployment takes longer as packages are downloaded. Subsequent deployments are faster.
Step 6: Finalize#
Once deployment completes:
Install the SSL Certificate#
To access HTTPS services without browser warnings:
- Click "Install Certificate"
- Follow the instructions for your system
This is a one-time setup per device. See our certificate installation guide for details.
Connect to the VPN#
- Go to the VPN tab in Siovos Desktop
- The configuration is automatically loaded
- Click "Connect"
Access Your Services#
With VPN connected, access your services:
| Service | Default URL | Credentials |
|---|---|---|
| Rancher | https://rancher.internal | admin / (configured) |
| Harbor | https://registry.internal | admin / (configured) |
| Grafana | https://grafana.internal | admin / (configured) |
Next Steps#
Your infrastructure is deployed! You can:
- Add VPN clients for your team
- Set up CI/CD
- Understand the architecture of your infrastructure
- Troubleshooting if needed
Need help? Contact support