shellhub-io

shellhub: Centralized SSH for Linux Devices Behind NAT

ShellHub is a Go-based SSH gateway for Linux devices and servers behind NAT or firewalls. Its device agent connects outbound to a central server, letting teams use standard SSH tools or a web terminal without exposing inbound ports.

ActiveGoApache-2.0Self HostedNetworkingSSH
Stars
2.2k
Forks
201
Stars, last 30 days
+179
Last commit
3 days ago
Contributors
51

Our take

Activeregular commits and releases

Health score

78/100

How it is scored
Activity
79
Community
78
Issues
68
Pull requests
85

+179 stars in the last 30 days

  • Merges more pull requests than 98% of the projects we track
  • Releases more often than 75% of the projects we track

ShellHub is an actively maintained Go project with frequent releases and contributions from a broad contributor base, making it a credible option for teams that want centralized SSH access without managing inbound connectivity on each device.

Good fit if

  • You need SSH access to Linux devices behind NAT or firewalls and can run an agent on each device.
  • Your team wants centralized identity, access policies and connection records while retaining standard SSH clients.
  • You want to self-host under Apache-2.0 or use the hosted ShellHub Cloud offering.

Look elsewhere if

  • You need a solution that works without installing an agent on target devices.
  • Your targets are not among the Linux and additional supported platforms documented by the project.
  • You require Cloud or Enterprise edition features such as MFA, server-side recording, web endpoints or SAML SSO in the community edition.
All health signals
Last commit2026-10-30 (3 days ago)
Commits, last 90 days100+
Releases, last 12 months21 (latest v0.29.0, 2026-10-30)
Contributors51 (top contributor: 28% of commits)
Issues closed, last 90 days5+ (typically closed in 1 day)
Pull requests merged, last 90 days97 (typically merged in 0 days)
Project age7 years

Checked on 2026-11-03 with the GitHub API.

Project history

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

Selected snapshot

Stars

2,249

Forks

202

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

Overview

ShellHub is a centralized SSH gateway for Linux devices and servers, including embedded and cloud systems that sit behind NAT or firewalls. A small agent on each device connects outbound to the ShellHub server, so teams can reach devices with standard SSH clients without assigning public IPs or opening inbound ports.

It ties access to team members rather than shared device keys, and provides a web console for managing devices and access. It supports Linux devices and servers, with packages also available for Yocto, Buildroot, FreeBSD and Snap.

Key Features

  • Connect with OpenSSH, PuTTY, scp, sftp and port forwarding.
  • Open device shells from a browser-based terminal.
  • Associate SSH logins with team members and revoke a person's access across devices by removing them from the team.
  • Define default-deny access policies by person, device and Linux user, with an option to require a fresh sign-in for each session.
  • Record connection details including user, source IP and device.
  • Group and filter devices with tags.
  • Enroll individual devices with pairing codes or provision fleets with a provisioning key.

Use Cases

  • Give a remote operations team SSH access to embedded Linux devices deployed in the field without exposing inbound ports.
  • Let infrastructure teams reach cloud instances and servers behind firewalls using their existing SSH clients.
  • Manage access for multiple engineers centrally, especially when staff changes require access to be revoked across devices.
  • Provision fleets of devices without manually pairing each one.

What you need

Detected in the repository

  • Go 1.26.10 or newer (from go.mod)
  • A Compose file to run it with its related services
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

For a self-hosted quick start, install Docker with Compose and run:

git clone -b v0.27.0 https://github.com/shellhub-io/shellhub.git
cd shellhub
make start

Then open http://<your-server>/setup and follow the setup flow. See the README and deployment guide for device enrollment and production configuration. Alternatively, create an account at ShellHub Cloud.

Alternatives

  • netmaker: Netmaker provides WireGuard network connectivity for reaching devices, rather than an SSH gateway with device-agent sessions and web terminal access.
ProjectLanguageLicenseStarsStatus
shellhubGoApache-2.02.2kActive
netmakerGo–11.8kActive

Considerations

  • Self-hosting requires Docker Compose and available host ports 80 and 22 for the documented quick start. The project also depends on an agent running on each target device.
  • The repository is active, with regular commits and releases and contributions from dozens of contributors; issue closure activity is more limited than its recent merge and release activity.
  • ShellHub's Community edition is Apache-2.0. The README describes MFA, server-side recording, web endpoints and SAML SSO as features of hosted Cloud or Enterprise editions, not the Community edition.

Found this useful?

Share it with someone who would like shellhub.

Comparisons