LANBox

LANBOX GUIDE

Expose a local service

A concise guide for HTTP, TCP, and UDP tunneling.

LANBox · · en

Create and connect

Start the local service and note its address and port. In Dashboard → Create, choose a nearby region and select HTTP, TCP, or UDP. Use 127.0.0.1 when the service runs on the same computer as LANBox.

Download lanbox.toml after creating the tunnel. It contains private credentials, so do not share it. Put it beside the Windows beginner client and double-click the client, or start the expert client from Terminal.

chmod +x lanbox
./lanbox -c lanbox.toml

Choose a protocol

Use HTTP for websites, APIs, and webhooks. LANBox assigns an HTTPS subdomain.

Use TCP for SSH, databases, Minecraft Java, and other TCP services. Use UDP for Minecraft Bedrock and other UDP services. TCP and UDP receive a public node address and port.

Common local ports are 3000 or 8080 for web apps, 22 for SSH, 25565 for Minecraft Java, and 19132 for Minecraft Bedrock.

Troubleshooting

The tunnel is online only while the LANBox client is running. Test the local service first, then verify localIP, localPort, protocol, and the tunnel status in Dashboard.

HTTP carries HTTP traffic only. A protocol or port mismatch is the most common connection failure.

If lanbox.toml is exposed, refresh the config key in Dashboard and download a new file. The old credential stops working immediately.

LANBox Dashboard · Download LANBox