Our take
- 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.
Stars
250Forks
11Change 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
sshexecutable. - 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.