# SSH server manager for Mac

> Watch, browse and run your servers and containers from one place.

- Canonical URL: https://getedith.pro/extensions/ssh-machines
- Category: [Agents & Terminal](https://getedith.pro/extensions/category/coding-agents-and-terminal)
- Extension ID: `machines`
- Updated: 2026-11-15
- Part of: [Edith](https://getedith.pro/), a Mac app for macOS 14 or later on Apple silicon, [$35 once for one Mac, plus $7 for each additional Mac](https://getedith.pro/pricing)

Machines is an Edith extension that connects to any computer you can reach over SSH and shows its health, a terminal, its files and its Docker containers in one place, with your own Mac listed first.

## Overview

Add a machine by address and username, or pick a host straight from your SSH config, and it joins a fleet view with live CPU, memory, disks, temperatures, GPUs and processes. Edith runs the macOS OpenSSH client, so your keys, agent and config work as they do in Terminal, and it keeps one shared connection per machine for every terminal, file listing and command. Macs, Linux servers and Windows PCs running an SSH server all work. Edith can notify you when a machine stops responding, again when it comes back, and when a disk passes a level you set, 90 percent by default.

Pick a machine to open terminal tabs, browse and transfer files in a Finder-style browser that can undo its last move or rename, or mount the machine's file system on your Mac with sshfs. The Docker tab lists containers with live stats, plus images, volumes, networks and Compose projects, and can start, stop, restart, remove or follow the logs of any of them. Workspaces put terminals from several machines side by side in split panes and remember the layout.

Some jobs are about the hardware itself. Live controls set volume, brightness, Wi-Fi, Bluetooth, Do Not Disturb and keyboard backlight where the machine supports them. You can also switch thermal profiles, with an optional timer that reverts the change, and restart, shut down, or wake a sleeping machine with a Wake-on-LAN packet. Saved port forwards bring a remote service to localhost, and snippets keep the commands you run on each machine one click away. Removing a machine only forgets it; nothing on the machine changes.

- Live CPU, memory, disks, temperatures, GPUs and processes for every host.
- Terminal tabs, file browsing and transfer, remote previews and saved split-pane workspaces.
- Docker Compose groups, resources, configuration and logs, with start, stop, restart and remove.
- Wake, restart or shut down hosts, and read fan speeds with automatic rollback for profile changes.

## How to manage SSH servers and Docker containers from a Mac

1. **Add a machine**: Enter its address and username, or pick a host from your SSH config.
2. **Watch its health**: See CPU, memory, disk and containers at a glance, and control volume, brightness, Wi-Fi, power and thermal profiles.
3. **Open a terminal or files**: Pick a machine to run commands, browse and transfer files, or manage Docker.
4. **Build a workspace**: Arrange terminals from several machines side by side in split panes.

## What you can do

- **Connect to a server over SSH**: Watch its health, open a terminal and browse its files.
- **Manage Docker containers**: Start, stop and read the logs of containers on your machines.

## Can a Mac manage SSH servers without extra software?

For the basics. macOS ships the OpenSSH client, so ssh, scp and sftp work in Terminal, and Finder's Connect to Server opens SMB and other network shares, though not SFTP. There is no built-in view of a remote machine's CPU, disks or containers. Machines adds live health, a remote file browser, Docker and Compose management, port forwards and saved workspaces on top of the same SSH you already use.

## Use cases

### Free disk space on a Docker host

When a VPS alert says the disk is at 92 percent, open the Docker tab or run ed machines docker df box to see whether images, volumes or build cache take the space. ed machines docker prune box images reclaims space from unused images, and removes nothing until you add --yes.

### Reach a database that only listens on the server

Save a port forward from local port 5433 to the server's Postgres on 5432 and switch it on. The database now answers on localhost, so the Database extension, or any client, can connect to it without opening the port to the internet.

### Run one command across every box

Before a maintenance window, ed machines broadcast runs uptime, or a package update, on every machine at once, so you can spot the one that needs attention before you start.

### Edit server files in your Mac editor

Mount a machine's file system with ed machines mount box, reveal it in Finder, and open its config files in the editor you already use. Edith offers to install sshfs and FUSE-T the first time.

## Command line and MCP

Run `ed machines` from Terminal, and add `--json` for JSON output. Coding agents connected to the [Edith MCP server](https://getedith.pro/mcp) call the same commands as tools whose names start with `edith_machines`.

```sh
ed machines ls
ed machines add box --host 10.0.0.4
ed machines show box
ed machines exec box uptime
```

## Permissions

- Keychain, for machine passwords and sudo passwords you choose to save
- Notifications, for down, back-up and disk-full alerts

## Requirements

- macOS 14 or later on Apple silicon
- SSH access to each machine you add
- Docker on a machine, for its Docker tab
- sshfs and FUSE-T, only for mounting, installed from the tab

## FAQ

### Does Machines use my existing SSH keys and config?

Yes. It runs /usr/bin/ssh, the client that ships with macOS, so keys in ~/.ssh, your SSH agent and hosts in ~/.ssh/config work unchanged. If a machine needs a password, you can save it in your Keychain.

### Will removing a machine change anything on it?

No. Removing forgets the machine on your Mac, along with its saved port forwards, snippets and stored secrets. Nothing is installed on or deleted from the machine itself.

### Can Claude Code run commands on my servers over MCP?

Yes. The ed machines commands are tools in Edith's MCP server, including edith_machines_exec to run a command, edith_machines_docker_ps to list containers and edith_machines_files_get to fetch a file. Anything that changes or removes something shows a preview until the call confirms it.

### Does it work with Linux and Windows machines?

Yes. Edith detects whether a machine runs macOS, Linux or Windows and uses the right commands for metrics, services and power. A Windows PC needs its OpenSSH server turned on.

### Can I see a server's files in Finder?

Yes, by mounting it. ed machines mount puts the machine's file system on your Mac through sshfs, and ed machines mount-reveal opens it in Finder. The built-in browser works without mounting.

### Is Machines included in Edith's one-time price?

Yes. Machines comes with every Edith license, with no per-server or per-seat fee.

## Works well with

- [Database GUI for Mac: Postgres, MySQL, SQLite](https://getedith.pro/extensions/database-client): Browse and safely edit your databases without leaving your Mac.
- [CPU and Memory Monitor for the Mac Menu Bar](https://getedith.pro/extensions/menu-bar-stats): See how busy your Mac is, right in the menu bar.
- [Run Multiple Claude Code and Codex Agents on Mac](https://getedith.pro/extensions/coding-agents): See every coding agent on your Macs in one board, and step in when one needs you.

## Guides

- [How to Add an MCP Server to Claude Code on Mac](https://getedith.pro/guides/add-mcp-server-claude-code): Add an MCP server to Claude Code on a Mac with claude mcp add, pick the right scope, check it with /mcp, and connect Edith's tools in one command.

## Use cases

- [Run Coding Agents Overnight on a Mac With Edith](https://getedith.pro/use-cases/run-coding-agents-overnight): Run Claude Code and Codex agents overnight on a Mac: keep it awake with the lid closed, queue the next task, and wake up to limits, costs and results.
- [Manage Servers From Your Mac With Edith](https://getedith.pro/use-cases/manage-servers-from-your-mac): Manage SSH servers from your Mac: health, terminals, Docker, port forwards, a database client and agent usage across machines, from one app and the ed CLI.

## Compare

- [Edith vs Raycast: One-Time Mac Toolkit Compared](https://getedith.pro/compare/edith-vs-raycast): Edith vs Raycast on Mac: a free launcher with paid AI plans, or one payment for a launcher plus agent usage, MCP control and Mac utilities.
- [ccusage Alternative for Mac: Menu Bar Usage Tracker](https://getedith.pro/alternatives/ccusage): A ccusage alternative for Mac: Claude Code and Codex cost and live rate limits in the menu bar, with alerts and SSH fleet totals. Paid once, with a CLI.
