How to Connect to Your VPS via SSH
This guide explains how to securely connect to your LumaDock VPS using SSH from Windows, macOS, or Linux. SSH (Secure Shell) is the most common and secure way to manage your server remotely.
1. What You Need
- Your VPS IP address (visible in your control panel)
- Your username (default:
root
for KVM VPS) - Your password or SSH key
All the credentials and information you need to connect to your server are sent to your registered email once when your VPS is deployed.
2. Windows: Using PowerShell or Windows Terminal
- Press
Windows + S
, search for PowerShell or Terminal, and open it. - Run this command (replace with your actual IP):
ssh root@your.vps.ip.address
- Accept the fingerprint by typing
yes
if prompted. - Enter your VPS password when asked.
Or use PuTTY
- Download PuTTY.
- Enter your VPS IP into the Host Name field.
- Port:
22
| Connection Type: SSH - Click Open and log in as
root
.
3. macOS: Using Terminal
- Open the Terminal app.
- Run the following:
ssh root@your.vps.ip.address
- Accept the fingerprint and enter your password when prompted.
4. Linux: Using Terminal
Same steps as macOS:
ssh root@your.vps.ip.address
Optional: Connecting with SSH Keys (Advanced)
- Generate keys on your computer:
ssh-keygen -t rsa -b 4096
- Upload your public key to your VPS:
cat ~/.ssh/id_rsa.pub | ssh root@your.vps.ip.address 'mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys'
- Next time, connect without typing your password:
ssh root@your.vps.ip.address
❓ Troubleshooting
Error | Cause | Solution |
---|---|---|
Permission denied (publickey) |
SSH key missing or wrong | Use password login or re-upload your key |
Connection refused |
SSH port is closed | Open port 22 in your firewall panel |
Host unreachable |
Wrong IP or network issue | Verify IP and try pinging the server |
Firewall Tip
Make sure TCP port 22 is open in your LumaDock firewall settings. You can manage firewall rules directly from your VPS panel.
Summary
System | Method | Command |
---|---|---|
Windows | Terminal / PuTTY | ssh root@ip |
macOS | Terminal | ssh root@ip |
Linux | Terminal | ssh root@ip |
If you need help, contact LumaDock Support — we’re here for you 24/7.