Get started
Documentation

Get started with VoidPort

Install the CLI, create a tunnel and put your local server online.

Quick Start

Get your local server online in under 2 minutes.

  1. Create an account

    Sign up at voidport.app/register

  2. Install the CLI

    $ curl -sSL https://dl.voidport.app/install.sh | sh

  3. Create a tunnel in the dashboard

    Go to Dashboard > Tunnels > Create Tunnel. Choose TCP or UDP and a name.

  4. Connect

    $ voidport connect <tunnel-id> --local 25565

    Replace 25565 with your local port (e.g., Minecraft server)

That's it! Your local server is now accessible at the public address shown in the dashboard.

Installation

Linux / macOS

$ curl -sSL https://dl.voidport.app/install.sh | sh

Windows

Download the installer from the releases page or use PowerShell:

PS> irm https://dl.voidport.app/install.ps1 | iex

Manual Download

Download binaries directly:

Verify Installation

$ voidport --version

Creating a Tunnel

Via Dashboard

  1. Log in to your dashboard
  2. Click "Create Tunnel"
  3. Enter a name (e.g., "minecraft-server")
  4. Select protocol: TCP, UDP, or Both
  5. Choose a relay region (Nuremberg, Helsinki, Ashburn or Hillsboro)
  6. Click "Create"

After creation, you'll see your tunnel ID and a connection token. The token is shown only once - copy it somewhere safe.

Connecting

Use the CLI to connect your local server to the tunnel:

$ voidport connect <tunnel-id> --local <port>

Example for a Minecraft server on port 25565:

$ voidport connect abc123 --local 25565

CLI Commands

connect

Connect a local port to a tunnel.

$ voidport connect <tunnel-id> --local <port> [--token <token>]
--local
Local port to expose (required)
--token
Tunnel token (prompted if not provided)

status

Show connection status and statistics.

$ voidport status

update

Check for and install CLI updates.

$ voidport update

version

Show CLI version.

$ voidport --version

TCP vs UDP

ProtocolUse CaseExamples
TCPReliable, ordered deliveryMinecraft Java, Web servers, SSH, FTP
UDPLow latency, real-timeMinecraft Bedrock, Voice chat, Game servers
BothGames using both protocolsSome game servers, streaming

Not sure which to choose? Most applications use TCP. Minecraft Java uses TCP, Minecraft Bedrock uses UDP.

Plans & Limits

FeatureGamerProHosting
Price€3/mo€8/mo€19/mo
Tunnels31025
Bandwidth20 GB100 GB500 GB
Connections1050Unlimited
Custom Domains-15
Sticky PortsYesYesYes

Sticky ports: Your public port stays the same across reconnects, so players don't need a new address.

Troubleshooting

Connection Failed

  • Verify your tunnel ID and token are correct
  • Check that your local server is running on the specified port
  • Ensure no firewall is blocking outbound connections

High Latency

  • Choose the relay closest to your players: Nuremberg or Helsinki for Europe, Ashburn (east) or Hillsboro (west) for the US
  • For real-time applications, use UDP if supported

Connection Limit Reached

  • Each plan limits concurrent connections per tunnel (Gamer 10, Pro 50, Hosting unlimited)
  • Upgrade to a higher plan for more connections

Bandwidth Exceeded

  • Usage resets monthly on your billing date
  • Upgrade to a higher plan for more bandwidth

Still Having Issues?

Contact support at support@voidport.app