Files
admin e9de263ee1 pocs (#51)
Reviewed-on: admin/ansible#51
Co-authored-by: rudolf <rudolfss13@gmail.com>
2026-10-05 23:54:20 +02:00

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:

  1. Docker is running with --privileged flag
  2. The host has /dev/net/tun (on Linux hosts)
  3. 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

References