> ## Documentation Index
> Fetch the complete documentation index at: https://yoursshlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DevOps Hub

> Manage containers, run network diagnostics, expose ports, catch mail, share files and browse S3 buckets from your SSH sessions.

DevOps Hub is a built-in plugin with seven tools. Most of them run on the host of an open SSH session, so connect to a host first.

## Open the hub

Click **DevOps Hub** in the sidebar under **Tools**. The hub has its own list on the left: **Containers**, **Network Tools**, **Cloudflare**, **LAN Share**, **Mail Catcher**, **MCP Server** and **S3 Browser**. The hub opens on **Network Tools**.

If **DevOps Hub** is missing, turn it on in **Plugins** under **BUILT-IN PLUGINS**.

![Plugins screen with the built-in plugins Snippets, DevOps Hub and Web Tools enabled and an empty script plugins section](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/15-plugins/01-manager.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=463d02f14433741a50130d3b10854a98)

The Plugins screen. DevOps Hub, Snippets and Web Tools can each be switched on or off.

> [!NOTE]
>
> Commands the hub runs on a host are recorded in the [audit log](https://yoursshlabs.com/user-guide/audit-log.md) with the source `devops`.

## Containers

**Containers** manages Docker, Docker Compose and Kubernetes on the remote host.

1. Pick a session from the list at the top. If no SSH session is open, the tool asks you to open one first.
2. Click the refresh button (**Rescan runtimes**), or **Scan**, to detect what is installed.
3. Switch between the **Docker**, **Compose** and **Kubernetes** tabs.

If a tool isn't installed on the host, the tab says so, for example **docker is not installed on this host**, and offers **Copy command** with the install hint.

![Containers tool with the Docker, Compose and Kubernetes tabs and a message that docker is not installed on this host with a Copy command button](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/03-containers-no-docker.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=1382da1ea034ac370f0933c206fb14a6)

Docker is not installed on this host: the tab shows an install hint instead of an empty list.

### Docker

The **Docker** tab lists all containers, running and stopped, with image and status. Each container has icon buttons. Hover one to see its name:

| Button | What it does |
| - | - |
| **Stop**, **Restart**, **Start** | Change the container state. Which one shows depends on the current state. |
| **Exec** | Opens a shell inside the container. |
| **Logs** | Shows the live log below the list. |

### Compose

The **Compose** tab lists Compose stacks found on the host. Use **Add path manually** to add a stack that isn't found. For each stack you can bring it **Up** or **Down** and select it to see its services. **Down** asks you to confirm first. For each service you can start, stop and open **Logs**. Docker Compose v2 is required.

### Kubernetes

The **Kubernetes** tab lists pods. Filter by **Namespace** or turn on **All namespaces**. For a pod you can **Exec** into a container, open **Logs** or use **Forward port** to forward a pod port to a local port. `kubectl` must be installed on the host.

## Network tools

**Network Tools** runs diagnostics on the host of the active session. Pick a tool from the list. Most tools ask for a target such as a host, URL or path. **Netstat**, **Top Processes** and **Memory Info** don't. Click the run button, which carries the tool's name. Without an open SSH session the tool shows **No active session — connect to a host first**.

| Group | Tools |
| - | - |
| **NETWORK** | **Ping**, **cURL**, **DNS Lookup**, **Traceroute**, **Port Scan**, **Whois**, **Netstat** |
| **SYSTEM** | **Disk Usage**, **Top Processes**, **Memory Info** |
| **HTTP** | **HTTP Headers**, **SSL Certificate** |

The commands run on the remote host, not on your computer. Each run opens a result tab. Use the copy button to copy the output and **Clear all tabs** to close them.

![Network Tools screen with Ping selected and the list of tools grouped as Network, System and HTTP](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/04-network-tools.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=788003b05e10ec9f26e65f3552795bc6)

Network Tools with the tool list. Most tools take a target such as a host, URL or path.

![Ping result tab showing four replies from 127.0.0.1 and the ping statistics](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/05-ping-result.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=c2c381686027d7d6ae0315c14f3e9d6f)

A ping result in its own tab, with the run time.

## Cloudflare tunnels

**Cloudflare** starts a quick tunnel with `cloudflared` on the remote host and gives you a public HTTPS URL for a port on that host. Use it to share a dev server without changing firewall rules.

**1. Connect to a host**

The tool needs an active SSH session. `cloudflared` must be installed on that host.

**2. Add a tunnel**

Click **New Tunnel**. Enter a **Label** and the **Local Port** (1–65535), then click **Add Tunnel**. Empty or invalid fields show **Required** or **Invalid (1–65535)**.

**3. Start it**

Click the start button on the tunnel. When it is running, use **Copy URL** to copy the public address. The stop button ends it. **Remove** deletes the entry after you confirm **Remove tunnel**.

![Cloudflare Tunnels list with one tunnel named docs tunnel on port 8080](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/10-cloudflare-rule.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=448352e633a99551d15dfb74c423011f)

A saved tunnel with its local port, start button and delete button.

If `cloudflared` isn't installed on the host, starting a tunnel shows an error with the install command.

> [!WARNING]
>
> Anyone with the tunnel URL can reach that port while the tunnel runs. Stop the tunnel when you are done.

## LAN Share

**LAN Share** shares one file over HTTP on your local network.

1. Click **Pick File to Share** and choose a file on your computer.
2. YourSSH generates a local URL on port `8765` that contains a random token. Use **Copy URL** to copy it. The URL uses your Wi-Fi address, so the computer needs to be on Wi-Fi.
3. Anyone on the same network who has the URL can download the file with a browser. The link is plain HTTP.

Click **Stop Sharing** when you are done. Sharing also stops when you switch to another tool in the hub, and the link only works while YourSSH is running.

## Mail Catcher

**Mail Catcher** starts a small SMTP server on the remote host so you can test the mail your app sends, without delivering it. It needs `python3` on the host.

**1. Start it**

Click the start button (its tooltip reads **Start on port 1025**). The header then shows **Listening on :1025**.

**2. Point your app at it**

Configure the app on that host to send mail to SMTP port `1025`.

**3. Read the mail**

Captured messages appear in the list with the sender and time. Select one to see **Subject**, **From**, **To**, **Received** and the body.

![Mail Catcher listening on port 1025 with one captured message and its subject, sender, recipient and body](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/16-mail-detail.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=c97f088a6dc715cce38799859d8194d8)

A captured message. The list is on the left and the detail on the right.

Click **Clear all** (the clear button in the header) to remove every captured message. YourSSH asks **Clear captured mail?** first, because the messages are also removed from the catcher log on the host. Click **Stop** to shut the server down.

![Clear captured mail confirmation dialog with Cancel and Clear buttons](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/17-mail-clear-confirm.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=0b7c420ed8009e10fc91699191e2366a)

Clear all asks for confirmation before it deletes anything.

## MCP Server

**MCP Server** runs a Model Context Protocol server on the remote host and makes it available on a local port, so an AI client on your computer can use it.

1. Enter the **MCP Server Command** that starts the server on the host. The default is `npx @anthropic-ai/mcp-server`.
2. Set the **Local Port** (default `9090`).
3. Click **Start MCP Server**.

YourSSH forwards the port over SSH and shows the endpoint, with a button to copy it. Point your AI tool at that endpoint. Click **Stop MCP Server** to end it. The page explains the flow under **How it works**.

![MCP Server Gateway screen with the command field, the local port 9090 and the Start MCP Server button](https://mintcdn.com/your-ssh/vNM8XA5Zlrh1XSOb/images/17-devops/18-mcp-server.png?fit=max\&auto=format\&n=vNM8XA5Zlrh1XSOb\&q=85\&s=3d21195f82fe9d9dd35c764adc416dc1)

The MCP Server Gateway form.

## S3 Browser

**S3 Browser** browses S3-compatible storage such as AWS S3, MinIO and Cloudflare R2. It talks to the bucket directly from your computer, so it doesn't need an SSH session.

**1. Add a bucket**

Click **Add Bucket** and fill in **Display Name**, **Endpoint**, **Bucket**, **Region**, **Access Key** and **Secret Key**. Click **Save**.

**2. Browse**

Open the bucket to see its folders and objects. You can upload, create a folder with **New Folder**, rename or move an object, copy a download URL, download an object to your `Downloads` folder and delete objects.

Bucket settings, including the keys, are stored in the system credential store. Use **Edit Bucket** and **Remove Bucket** to change or delete a saved bucket.

![S3 Browser with the message No buckets configured and an Add Bucket button](https://mintcdn.com/your-ssh/hXl_1tpHLWW6nFrV/images/17-devops/19-s3-browser.png?fit=max\&auto=format\&n=hXl_1tpHLWW6nFrV\&q=85\&s=4842ac4b00b2b8d1b0677f017e4f6750)

S3 Browser before any bucket is added.

## Related pages

> [card] [Web Tools](https://yoursshlabs.com/user-guide/web-tools.md)
>
> HTTP client, utilities and an embedded browser.

> [card] [Port forwarding](https://yoursshlabs.com/user-guide/port-forwarding.md)
>
> Tunnels behind the MCP server and browser.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.