Installation Guide: Windows, macOS, Linux, and Docker

This guide focuses on one goal: install vLanIO and get it running fast.

Before you start

Confirm:

  • your device is online
  • you have install permission
  • you already decided where shared files should be stored

macOS

  1. Download the macOS package from the official site
  2. Complete system install flow
  3. Launch and verify service status page

Windows

  1. Download the Windows installer
  2. Finish setup wizard
  3. Launch and confirm address/QR is shown

Linux (desktop)

  1. Download the package for your distribution
  2. Install with system package workflow
  3. Launch and verify service is running

Docker (server or NAS)

docker run -d \
  --name vlanio \
  -p 8080:8080 \
  -v /data/share:/shared \
  docker.vlanio.com/vlanio:latest

After startup, open the mapped address from another device in the same network.

3 post-install checks

  1. service is running
  2. another device can access it
  3. one small file upload works

Quick install FAQ

Q: Installed but page does not open?
A: Check service status, firewall rules, and network segment.

Q: Corporate device blocks install?
A: Use approved deployment path or ask IT to allow required actions.

Q: Docker container runs but not reachable?
A: Re-check port mapping and volume mount paths.

Next steps