Install & Run Localtonet with Docker

Use Docker to run Localtonet as a lightweight, isolated container. You can pull the latest image and authenticate it with your token.

1) Pull the Latest Image

This ensures you have the most up-to-date version of Localtonet:

Pull image
docker pull localtonet/localtonet

2) Run the Container with Authentication

Start the container and pass your authentication token. Replace <YOUR_TOKEN> with your actual token from the Dashboard → My Tokens page:

Run container
docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

3) (Optional) Run Detached & Restart Automatically

To run Localtonet in the background and ensure it restarts automatically:

Run as background service
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

4) Manage the Container

  • docker ps — view running containers
  • docker logs -f localtonet — stream logs
  • docker stop localtonet — stop the container
  • docker start localtonet — start again
  • docker rm -f localtonet — remove container
Tip: Mount configuration or tunnel definitions using -v if you want persistence across restarts.