Documentation

Everything you need to get started.

Learn how to set up Horizon on your server, connect with Voyager from any device, and configure remote access through Wormhole.

Get connected in minutes

Follow these three steps to start accessing your terminal remotely.

Step 1

Install Horizon

Download and run Horizon on the computer you want to access remotely. Keep it running to accept connections.

Step 2

Connect via LAN

For local network connections:

  • HorizonEnable Allow LAN Access in Sharing
  • CopyThe URL shown in Horizon
  • VoyagerEnable LAN mode, paste URL
Step 3

Connect via Wormhole

For remote access outside LAN:

  • HorizonEnable Allow Remote Access
  • ConfigureWormhole URL and Access Token
  • VoyagerEnter Session ID and connect

How Blackhole works

Understanding the three components and connection modes.

Components

  • HorizonServer running on your host machine
  • VoyagerClient app for remote access
  • WormholeRelay server for NAT traversal

Connection Modes

  • LANDirect connection, lowest latency
  • WANThrough Wormhole relay server

Configure access

Control how devices connect to your Horizon server.

LAN Access

Enable direct connections on your local network. Horizon advertises a WebSocket address that Voyager can connect to directly.

Remote Access

Use Wormhole relay when outside LAN. Configure the relay URL and access token in Horizon settings.

Device Trust

New devices require approval on first connection. Trusted devices reconnect automatically.

Common issues

Solutions to frequently encountered problems.

Connection fails

Verify Horizon is running and the URL/Session ID is correct. Check firewall settings.

Wormhole offline

Confirm URL scheme (ws/wss) and token match the relay server configuration.

Input not working

Ensure the session is active. Try reconnecting or restarting the session.