New in 0.14 · Agent updates from the hub

Every machine on your LAN, one browser tab.

LANHub is a private, self-hosted file explorer that replaces unreliable SMB shares. Register each computer you own, and browse, move, copy, and search across all of them — from any browser, with drag-and-drop between machines. Dark mode included, because most of this gets used at night.

Version 0.11 rebuilds the hub as one small, fast program: a 15 MB download instead of 883 MB, copies between machines nearly twice as fast, and video previews for almost any format. From 0.12, it updates itself: one click in Settings, or one click in the email it sends you. In 0.13, copies between two machines go straight from one to the other, checked end to end, instead of through the hub. And in 0.14, the agents install with one line and update from the hub with one click.

LANHub dashboard showing live status and storage for every registered machine
01 · DASHBOARD

Every machine, at a glance — and in hand

The moment LANHub loads, you know exactly where things stand: which machines are online, how much room's left on every drive, and how fast each one is moving data right now. Expand any machine to ping it, jump into its files, or edit its details — no separate page required.

  • Live online/offline status and free-vs-total space per drive
  • Real-time upload/download speed, per machine
  • Ping, browse, edit, or remove a machine without leaving the page
Dashboard page with Studio Tower expanded, showing drive usage bars and live upstream/downstream speed graphs
02 · EXPLORER

Browse them all side by side

Open any registered machine into its own pane and work across all of them at once. Drag a file or a whole folder from one pane to another to copy it — hold Ctrl to move it instead.

Can't remember which machine a file is on? The search bar at the top checks every machine you have access to and tells you.

  • Unlimited open panes, one per machine or several on the same one
  • Drag-and-drop copy/move of files of any size and whole folders, same-machine or cross-machine
  • Search a single folder, or every machine on the network — all machines are searched at the same time
  • Copies stream straight from one machine to the other, and every file's size is checked when it lands
Explorer page with four open panes, one per machine, and a network-wide search bar
03 · VIDEO PREVIEWS

Preview almost any video, right in the browser

Click a video in the Explorer and it plays — MP4, MKV, AVI, MOV, WMV, WebM, MPEG, FLV, HEVC, ProRes and more. Files your browser can already play stream as they are. Everything else is converted on the fly by LANHub Media, a small companion that runs next to the hub, using your server's graphics chip when it has one.

  • Starts in a couple of seconds, seek anywhere, full screen
  • Converts only what you watch, and stops the moment you close it
  • Images fit the window; audio files play too
LANHub's video player in the Explorer playing an HEVC test clip, converted by LANHub Media on the GPU, with seek bar, volume and full-screen controls
04 · AGENTS

Know your agents are healthy

Every registered machine runs a small agent that talks to the hub. This page shows exactly how each one is doing — whether it's actually reachable right now, and how much data it's moved — without digging through the Activity log yourself.

  • Opens instantly, then checks each agent live, so one sleeping machine never holds up the page
  • Online status and last-seen heartbeat, per agent
  • Each agent's version, and whether it can do direct transfers
  • An Update button when an agent is behind the hub, and Update all for every machine at once
  • Sent/received totals with a running average throughput
  • One click through to that machine's full transfer log
Agents page showing online status, last-seen heartbeat, and sent/received throughput for every registered machine
05 · ACTIVITY

An audit trail you can actually search

Every request any machine's agent handles is logged — which machine, what was done, to which file, by whom, and whether it worked. The page opens instantly and loads only what you ask for: pick a machine, an action and a result, or just press Show activity for everything.

  • Filter by machine, method and status; routine background checks hidden unless you want them
  • Each entry shows the file and the folder it was in, in plain readable form
  • Who asked for it: a person, or the hub itself
Activity page with Machine, Method and Status filters, a background-checks switch, and Show activity and Clear filters buttons
06 · SYNC RULES

Set it and forget it

Keep a folder on one machine automatically mirrored to another — one-way or two-way, on a schedule you set. If a file changed on both ends since the last sync, LANHub flags the conflict instead of silently picking a winner.

  • One-way or mirrored sync between any two machines
  • Runs on a schedule, no manual trigger needed
  • Conflict detection before anything gets overwritten
Sync Rules page with a New Rule button for scheduling folder sync between machines
07 · SETTINGS

Mail that just works

Configure outgoing SMTP once from Settings, and invites, 2FA login codes, and password resets start actually landing in inboxes — instead of being written to a server log nobody reads.

  • One form, no .env editing or server access required
  • Email links use your hub's address, filled in automatically at setup
  • Test button sends a real email to yourself before you rely on it
  • Takes effect immediately — no restart needed
  • Its own Email tab in Settings, next to Updates
Settings page with the hub address used in email links, and an SMTP configuration form for host, port, encryption, username, and password
08 · UPDATES

Updates in one click — no terminal

Settings → Updates shows what you're running and what's published, with the release notes. Click Update and LANHub downloads the new version, checks it, and restarts — back in about five seconds. When a new version comes out, admins get a banner and an email with an Update LANHub button.

  • Downloads from the same published images docker compose pull uses, every file checked against its checksum
  • No Docker socket or root access handed to the hub
  • If a new version won't start, LANHub goes back to the one in its image by itself
  • LANHub Media updates too, the moment no video is playing
Settings page, Updates tab: this hub's and LANHub Media's versions, the latest published version, Check for updates and Update buttons, and the release notes for the new version
09 · APPEARANCE

Easy on the eyes, day or night

Flip the switch in the top nav and the whole interface follows — dashboards, file panes, logs, everything. Your choice is remembered, so it's there again next time you open the tab.

  • One-click toggle in the navigation bar
  • Applies instantly across every page
  • Remembered per-browser, no account setting needed
LIGHT
LANHub dashboard in light mode
DARK
LANHub dashboard in dark mode
10 · SIGN-IN

Two-factor login, your way

Every login asks for a second step. Scan a QR code once with Google Authenticator, Microsoft Authenticator, Authy, 1Password, or any authenticator app, and sign in with the 6-digit code it shows — no waiting on an email. Prefer email? That works too.

  • Works with any authenticator app — no email server needed
  • One-time recovery codes if you ever lose your phone
  • Every code works once; secrets are encrypted at rest
SET UP
Profile page showing a QR code to scan with an authenticator app, the matching setup key, and a box for the 6-digit code
SIGN IN
LANHub sign-in screen asking for the 6-digit code from an authenticator app, with an option to email a code instead
11 · LIGHTER & FASTER

Runs happily on an old laptop

LANHub 0.11 replaces the hub's web-app stack with a single small program. Same pages, same database, same logins and agents — just far less of everything. Measured on the same hand-me-down laptop that served the old version:

  • Pages stay instant while big downloads run, instead of queuing behind them
  • Nothing to tune: no workers, no PHP, no web server inside the container
  • Your agents don't change: existing ones keep working with the new hub
# same laptop, 0.9 → 0.11
Docker image     883 MB → 15 MB
Memory, idle      91 MB → ~10 MB
Copy 1 GB          194 s → 101 s
Page, 6 downloads 17.6 s → 0.4 s
Search 2 machines 10.9 s → 6.8 s
12 · DIRECT TRANSFERS

Machine to machine, not through the hub

Drag a file from one computer to another and the two agents now move it between themselves. The hub just coordinates, so a copy runs at the speed of the two machines' own connections and the hub stays idle — however slow the box it runs on.

  • Every file checked with a SHA-256 checksum on both ends before it gets its real name
  • Half-copied files stay hidden, and a dropped connection picks up where it stopped
  • Never overwrites a file that's already there; a move deletes the original only once every file has arrived
  • Each transfer uses a short-lived, single-file pass, so no machine ever learns another's key
  • Older agents, or machines that can't see each other, fall back to the hub automatically
# 200 MB, server → old laptop, 0.12 → 0.13
Through the hub    41.6 s
Direct             19.9 s

# needs agent 1.3.0 on both machines
13 · AGENT UPDATES

One line to install, one click to update

Add a machine and the hub hands you a single command, for Linux or Windows, that downloads the agent from your own hub, checks it and sets it up with that machine's token. After that, when a new agent comes out with the hub, the Agents page shows an Update button.

  • Every download checked against its SHA-256 before anything is replaced
  • Agents only accept updates signed with LANHub's release key, so a stolen token can't push a program of someone else's
  • The new agent is test-run first; if Windows blocks it, the current one keeps running
  • Never goes back to an older version, and keeps the previous one beside it
# Linux
$ curl -fsSL http://<hub>/agent/install.sh | sudo bash -s -- --token TOKEN

# Windows, Terminal (Admin)
> & ([scriptblock]::Create((irm 'http://<hub>/agent/install.ps1'))) -Token 'TOKEN'

# agent 1.4.0 and later: Agents → Update agent
14 · INSTALL

Up and running in two commands

No config files to edit, no keys to generate, no Docker know-how required. Grab one file, start it, and open the address in your browser — LANHub sets itself up and walks you through the rest. Works the same on Dokploy, Coolify, or Portainer: paste the file in and deploy.

  • Finds its own address — IP, hostname, or your own domain
  • Database, encryption key and the LANHub Media link created automatically on first start
  • In-browser setup wizard for your admin account
$ curl -O https://raw.githubusercontent.com/AC3Labs/LANHub/main/docker-compose.yml
$ docker compose up -d

# then open http://<your-server>:8949