First Deployment

This guide walks you through deploying your first infrastructure with Siovos Desktop. The process typically takes 15 to 30 minutes depending on your server's specifications.

Before You Begin#

Make sure you have:

• Siovos Desktop installed and license activated
• A remote server (VPS) with Debian 13
• Root SSH access to your server
• Your server's IP address
• An SSH private key for authentication

Step 1: Launch the Configuration Wizard#

1. Open Siovos Desktop
2. Click "New Deployment" from the dashboard
3. The configuration wizard will launch

Step 2: Server Configuration#

You'll need to provide your server details:

Server Information#

• Server IP Address: Your VPS's public IP (e.g., 203.0.113.42)
• SSH User: Usually root (or a sudo user)
• SSH Port: Default is 22
• SSH Private Key: Click "Browse" to select your SSH key file

Test Connection#

Click "Test Connection" to verify Siovos Desktop can reach your server. This will:

• Verify the IP address is reachable
• Test SSH authentication
• Check OS compatibility
• Verify root/sudo access

If the test fails, see the troubleshooting guide.

Step 3: Choose a Deployment Profile#

Siovos Desktop offers pre-configured deployment profiles to simplify your setup. Choose the one that best fits your needs:

Available Profiles#

Customize Passwords (Optional)#

Before applying a profile, you can customize passwords for included services:

1. Click "Customize" on your chosen profile
2. A modal opens with password fields for WireGuard, Harbor, PostgreSQL, Step-CA
3. Enter your own passwords or click the refresh button to generate secure ones
4. Click "Continue with this profile" to apply

Custom Service Selection (Business)#

Users with a Business license can configure services individually instead of using a predefined profile:

1. Click "Manual Configuration" at the bottom of the profiles list
2. Toggle each service on or off according to your needs
3. Dependencies are handled automatically (enabling Harbor also enables K3s)
4. Configure DNS subdomains via the "DNS" button

This option provides full flexibility for infrastructures with specific requirements.

Step 4: Configure Domain & Networking#

Configure how your services will be accessed:

• Base Domain: (Optional) e.g., myinfra.com for service subdomains
• VPN Network: Default is 10.8.0.0/24 (usually fine)
• Admin Password: Set a strong password for web interfaces

Step 5: Review & Deploy#

Review your configuration summary. The wizard shows:

• Selected services
• Server resources that will be used
• Post-deployment access URLs

When ready, click "Start Deployment".

Step 6: Monitor Progress#

The deployment runs automatically on your server. You'll see real-time progress including:

• Current task being executed
• Completion percentage
• Detailed logs (expandable)

Deployment Phases#

Step 7: Retrieve Artifacts#

Once deployment completes, Siovos Desktop automatically downloads:

• WireGuard configuration file (wg0.conf)
• Root CA certificate for HTTPS access
• Access credentials for services
• Connection instructions

Step 8: Install Root Certificate#

To access HTTPS services without browser warnings, install the Root CA certificate:

1. After deployment, click "Install Root CA" in the green banner
2. Or later: go to My Infrastructures → your server → Actions tab → "Install Root CA"

Step 9: Connect to VPN#

To access your deployed services:

1. Go to the VPN tab in Siovos Desktop
2. The WireGuard configuration is automatically loaded
3. Click "Connect"
4. Wait for connection confirmation

Step 10: Access Your Services#

With VPN connected, you can access your services:

Next Steps#

Congratulations! Your infrastructure is now deployed. You can:

• Deploy containerized applications to Kubernetes
• Push Docker images to your private Harbor registry
• Manage your cluster through Rancher
• Store application data in PostgreSQL

Need help? Contact support