strandnerd

tunn: Manage SSH Tunnels from a YAML Config

tunn launches and monitors SSH port forwards from a single YAML configuration, using your existing OpenSSH setup. It suits developers who need a simple way to run selected tunnels together or manage them in the background.

View on GitHub Compare
Stars
252
Forks
11
Stars, last 30 days
-1

Our take

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

-1 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

250

Forks

11

Change since Nov 17, 2026: 0 stars·0 forks

Overview

tunn is a Go command-line tool for defining and running SSH port forwards through one YAML configuration. It starts the system ssh binary for each port mapping, so it works with existing OpenSSH hosts, keys, and settings rather than replacing them.

It is useful when several tunnels need to be started together, selected by name, or run in the background with status and stop commands. The project supports macOS and Linux; Windows support is planned but not currently available.

Key Features

  • Define multiple named tunnels in one YAML file.
  • Map multiple local ports to remote ports for each tunnel.
  • Start all configured tunnels or select specific ones by name.
  • Run tunnel processes concurrently, with one process per port mapping.
  • Reuse system OpenSSH configuration and the ssh executable.
  • Detach tunnels into a daemon and check their status or stop them through the CLI.

Use Cases

  • Developers can start several local services' SSH forwards with one command while working against remote environments.
  • Database users can forward local ports to remote MySQL or PostgreSQL services without repeatedly entering SSH commands.
  • Teams can keep named tunnel definitions in a shared configuration pattern and start only the services needed for a task.
  • Users who want long-running forwards can detach them and inspect or stop the daemon from the terminal.

Getting Started

Install with Go:

go install github.com/strandnerd/tunn@latest

Then configure tunnels in ~/.tunnrc and run tunn. See the README for configuration examples and additional commands.

Considerations

  • Requires the OpenSSH client and a valid SSH setup. Building from source requires Go 1.21 or higher.
  • macOS and Linux are supported today; Windows support is planned, not available.
  • Detached mode relies on Unix domain sockets and runtime files, so its documented implementation is aimed at Unix-like systems.
  • Tunnel definitions are configuration, not an SSH replacement. Authentication and host behavior depend on the system's OpenSSH setup.

Found this useful?

Share it with someone who would like tunn.

Comparisons