3.2 KiB
Start the Node
The node will automatically generate its encryption key and configuration on first startup:
docker run -d \
--name anywherelan-node \
--restart unless-stopped \
--privileged \
-v awl-config:/data \
anywherelan:v0.17.0
Flags explained:
-d: Run in background (detached mode)--restart unless-stopped: Auto-restart on failure--privileged: Required for network interface creation (TUN/TAP device)-v awl-config:/data: Create and mount a named volume for config/key storage
The container will generate network.key and config.json in the awl-config volume on first run.
Verify Node is Running
docker ps | grep anywherelan
docker logs anywherelan-node
Web Interface
The node exposes a web interface on port 8639. Access it at:
http://localhost:8639
Docker Compose Alternative
Create a docker-compose.yml file:
version: '3.8'
services:
anywherelan:
image: anywherelan:v0.17.0
container_name: anywherelan-node
restart: unless-stopped
privileged: true
volumes:
- awl-config:/data
ports:
- "8639:8639"
volumes:
awl-config:
Then start with:
docker-compose up -d
The network key and configuration will be automatically generated on first startup.
Stopping the Node
docker stop anywherelan-node
Removing the Node
docker rm anywherelan-node
To also remove the configuration volume:
docker volume rm awl-config
⚠️ Warning: Removing the volume will delete all configuration and keys. Only do this if you want a fresh start.
Configuration
Configuration is stored in the awl-config volume:
network.key: Your node's encryption key (auto-generated)config.json: Node configuration (auto-generated)
To access or backup configuration:
# View volume location
docker volume inspect awl-config
# Backup configuration
docker run --rm -v awl-config:/data -v $(pwd):/backup alpine cp -r /data /backup/awl-config-backup
# Restore configuration
docker run --rm -v awl-config:/data -v $(pwd):/backup alpine cp -r /backup/awl-config-backup /data
Troubleshooting
Permission Denied Error
The --privileged flag is required for creating virtual network interfaces (TUN/TAP devices).
Port Already in Use
If port 8639 is taken, map to a different port:
docker run -d \
--name anywherelan-node \
--restart unless-stopped \
--privileged \
-p 8640:8639 \
-v awl-config:/data \
anywherelan:v0.17.0
Then access the web interface at http://localhost:8640
View Logs
docker logs -f anywherelan-node
Missing TUN Device
If you see "create tun: CreateTUN failed", ensure:
- Docker is running with
--privilegedflag - The host has
/dev/net/tun(on Linux hosts) - On non-Linux systems (Mac/Windows), Docker Desktop must have proper permissions
Inspect Volume
To see where Docker stores your volume:
docker volume inspect awl-config
Version
Built from tag: v0.17.0