Connecting to your servers (SSH)

Sometimes you want to look under the hood — to open a command line directly on the machine running your app. The Deployer lets you do that right from your browser, no extra software needed. This page explains what a server is, what SSH is, and how to connect safely.

A couple of quick definitions

• A server (also called a VM, short for virtual machine) is a computer running in your cloud that hosts your app. Your project may have one or several.
• SSH (Secure Shell) is the standard, secure way to open a text-based command line on a remote computer like that server.

You don't need to know either in depth to use the button below — but that's what's happening when you connect.

Finding your servers

Open your project's Dashboard and scroll to the Servers card. Each server is shown as a tile with:

• Its name and a status badge (for example, running).
• Its size, IP address (its number on the network), and region (which part of the world it lives in).
• Live CPU, RAM, and Disk meters — a quick read on how busy the processor, memory, and storage are. Green is comfortable; amber and red mean it's working hard.

Opening a terminal (Connect via SSH)

For an eligible server, the tile has a Connect via SSH button:

1. Click Connect via SSH on the server you want.
2. A full-screen terminal opens right inside your browser — no keys to set up, no separate app to install.
3. Type your commands at the prompt. You can open several servers at once in tabs, and minimizing keeps each session alive in the background.
4. Close the terminal when you're done.

When the button is available

The in-browser terminal is available for running servers — the real machines that host your app. If the button isn't there, the tile tells you why:

• "Managed — no shell" — that piece is a managed part of your setup that doesn't offer a command line.
• "Not reachable for SSH" — the server isn't in a state that can accept a connection right now.

A gentle safety note

A terminal gives you real, direct control of the machine running your app — which is powerful, and worth a little care:

• Commands run here take effect immediately and some can't be undone. Only run things you understand.
• Avoid deleting files, stopping services, or changing system settings unless you're sure what they do.
• You rarely need the terminal for everyday tasks — updating code is better done with Pull & Restart, and app settings with the environment variables manager, both of which are safer and leave a record in your Activity feed.

Think of SSH as the expert's back door: great to have when you need it, best left closed for routine work.