Applies to: LumaDock Cloud VPS • macOS (all versions)
macOS includes a built-in SSH client, so you can connect to your Linux VPS directly from the Terminal without installing any extra software. This guide shows you how to access your server securely using SSH.
Requirements
- A LumaDock Linux VPS
- Root login credentials (IP address, username, and password or SSH key)
- macOS device with Terminal app (pre-installed)
Step 1 — Open the Terminal
Click Launchpad → Other → Terminal, or press Command + Space and type Terminal, then press Enter to open it.
Step 2 — Locate Your VPS Login Details
In your LumaDock Client Area, open your VPS details page and note:
- IP Address (for example:
203.0.113.15
) - Username (usually
root
) - Password or SSH key (if configured)
Step 3 — Connect via SSH
Run the following command in your Terminal, replacing the IP address with your VPS IP:
ssh root@203.0.113.15
When connecting for the first time, you’ll be asked to confirm the server’s authenticity. Type yes
and press Enter.
Step 4 — Enter Your Password
When prompted, type your VPS password and press Enter. The characters won’t appear on screen — this is normal for security reasons.
Step 5 — You’re Connected
Once logged in, you’ll see a command prompt like this:
root@server:~#
You can now manage your VPS, install software, and run commands directly.
Optional — Use SSH Keys for Passwordless Login
SSH keys provide a more secure way to access your VPS.
- Generate a new key pair on your Mac:
ssh-keygen -t rsa -b 4096
- Copy the public key to your VPS:
ssh-copy-id root@203.0.113.15
- Connect securely without entering a password each time:
ssh root@203.0.113.15
Troubleshooting
- Permission denied: Verify the username and password or check that your SSH key is added correctly.
- Connection timed out: Ensure your VPS is online and port 22 is open in your firewall.
- No response or black screen: Try using the built-in browser SSH console in your LumaDock control panel.