selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Roamgate logo

Self-host Roamgate

v0.8.11

Web terminal client for Herdr agent workspaces

BetaOpen SourceMIT
curl -fsSL https://github.com/powerfooI/roamgate/releases/latest/download/install-roamgate.sh | sh
Updated9 hours ago
LanguageTypescript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
320
Ports
8787 (Default HTTP/WebSocket listener for the Roamgate bridge), 8788 (Development server port), 8443 (Example HTTPS port with TLS)
Desktop workspace reviewing code changes beside passing testsMobile code diff viewMobile terminal with Composer and shortcutsMobile static HTML preview of task boardDesktop Ranger workspace assistantMobile Ranger workspace assistantAnimated demo of handoff from computer to phone

What is Roamgate?

Roamgate is a browser-based client for Herdr, a terminal session manager that keeps coding agents running in the background. It provides a unified web interface to view and control terminals, inspect agent conversations, review code changes and diffs, manage Git worktrees, and monitor workspace status — all from a desktop browser or mobile device via PWA. The Roamgate bridge runs as a standalone binary alongside Herdr, connecting to Herdr's Unix sockets or named pipes to stream terminal output and handle file operations. It supports multiple Herdr connections via SSH, offers a real terminal with full keyboard input and touch controls, and includes an experimental AI workspace assistant called Ranger. Installation is via a checksum-verified installer script on Linux/macOS or binary archives on Windows. The project is MIT-licensed and open source.

Should you self-host Roamgate?

Roamgate scores 48/100 on selfhost.directory (how scoring works) and ranks #92 of 166 in Developer Tools. It has 320 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.8.11, came out on 27 October 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is openhands (87/100, 92 068 stars). It scores higher overall, so compare the two before you pick. See Roamgate vs openhands side by side.

Features

  • Agent awareness and session inspection
  • Code review and diff annotations
  • Custom themes and interface scaling
  • File explorer with previews
  • Git worktree lifecycle management
  • Managed Herdr setup
  • Multi-host via SSH
  • Native HTTPS/TLS
  • PR/MR status integration
  • Ranger AI workspace assistantExperimental
  • Real browser terminal
  • Systemd/user service management
  • Touch-safe terminal controls
  • Web push notifications

Roamgate README

How to install Roamgate

Install Roamgate with macOS

Linux or macOS
Environment variables
ROAMGATE_VERSION, ROAMGATE_INSTALL_DIR, ROAMGATE_RELEASE_BASE_URL
curl -fsSL \
  https://github.com/powerfooI/roamgate/releases/latest/download/install-roamgate.sh \
  | sh

Checksum-verified installer writes to ~/.local/bin/roamgate

How to configure Roamgate

  • HERDR_CLIENT_SOCKET_PATH~/.config/herdr/herdr-client.sockPath to Herdr client socket

    Path to Herdr client socket

  • HERDR_SOCKET_PATH~/.config/herdr/herdr.sockPath to Herdr control socket

    Path to Herdr control socket

  • HOST127.0.0.1Bind address for the bridge server

    Bind address for the bridge server

  • PORT8787Port for the bridge server

    Port for the bridge server

  • ROAMGATE_ALLOW_FILE_REVEAL0Enable host file reveal on loopback

    Enable host file reveal on loopback

    values: 1

  • ROAMGATE_DISABLE_ENDPOINT0Force legacy terminal mode

    Force legacy terminal mode

    values: 1

  • ROAMGATE_LOG_LEVELinfoLog level

    Log level

    values: debug, info, warn, error

  • ROAMGATE_NOTIFICATION_SOURCEherdrNotification source

    Notification source

    values: herdr, status

  • ROAMGATE_PASSWORDGenerated tokenPassword for authentication (8-1024 chars)

    Password for authentication (8-1024 chars)

  • ROAMGATE_PINDisabledOptional PIN for convenience login (6-12 digits)

    Optional PIN for convenience login (6-12 digits)

    values: 6-12 digits

  • ROAMGATE_SETTINGS_PATH~/.config/roamgateCustom settings directory

    Custom settings directory

  • ROAMGATE_TLS_CERTDisabledPath to PEM certificate chain for HTTPS

    Path to PEM certificate chain for HTTPS

  • ROAMGATE_TLS_KEYDisabledPath to PEM private key for HTTPS

    Path to PEM private key for HTTPS

Roamgate releases & version history

More in Terminal

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…