Install

FAQ

Questions, and how LANDA.SH compares

What you need, what it does on your network, and where it fits next to the dashboards, monitors and scanners you may already know.

The basics

What is LANDA.SH?

A homelab dashboard that builds itself. It's firmware for a small USB dongle that joins your Wi-Fi, finds every device on your network and the services each one runs, and turns them into a dashboard you open in a browser. When a device's IP address changes, its tiles follow it. You never edit a config file.

What hardware do I need?

One Waveshare ESP32-C6-GEEK, a USB stick with Wi-Fi and a small colour screen. It has to be that board; other ESP32 boards won't work. Plug it into anything that gives it power: a spare USB port on your router, NAS, TV or a phone charger. Details and where to buy one are on the home page.

Do I need a server, Docker or a Raspberry Pi?

No. The dashboard runs on the dongle itself. There's nothing to host, no containers and no database to look after.

What does it cost?

The firmware is free and open source under the GPL-3.0 licence. The only cost is the dongle. There's no subscription and no account.

How do I install it?

From the install section of the home page, in Chrome or Edge on a desktop or laptop. Plug the dongle in, press Install, and it's written over USB in about a minute. Then join the LANDA-XXXX network shown on its screen and pick your Wi-Fi. If you'd rather build it yourself, the source is on GitHub.

How do I open the dashboard?

Go to http://landash.local from any browser on your network, or type the IP address shown on the dongle's screen.

How does it get updates?

It checks for a new release twice a day and installs it by itself. If a new version doesn't start properly and get back online, the dongle goes back to the version it had. You can turn automatic updates off, or have them wait for you, under Settings › Maintenance.

On your network

How does it find devices?

Every few minutes it pings each address on your network in turn, at a steady pace, then reads which devices answered. It works out names from mDNS, SSDP, NetBIOS and your router's reverse DNS, and the maker from the MAC address. A slow background port scan then finds the services each device runs, and it repeats on a schedule so it notices when a service goes away.

Does it work with 5 GHz Wi-Fi?

The dongle itself needs a 2.4 GHz network to join, because the ESP32-C6 doesn't do 5 GHz. Most routers broadcast both. Devices connected at 5 GHz or by cable are found as normal, as long as they're on the same network.

How many devices can it handle?

It keeps up to 144 devices active and remembers up to 1,024. When the active list is full, the device that's been offline longest is stored away with its name, notes and ports, and comes back if it reappears. It sweeps networks up to a /16.

Does it see other VLANs or subnets?

No. It sweeps the network it's connected to. Devices on a separate VLAN, a guest network or behind another router won't show up.

Will the port scan set off my security software?

It might. The scan is paced, about 10 connection attempts a second by default, but an intrusion detection system can still spot it, especially at the deeper settings. You choose how far it goes during setup: off, about 120 common services (the default), ports 1 to 1024, or all 65,535. You can change it at any time under Settings › Scanning & health.

Does it need an internet connection?

Finding devices and serving the dashboard don't. The internet is used for the clock, the internet and DNS health check, and updates.

Can I use it from my phone?

Yes. The dashboard opens in any browser on your network. Only the first install needs a desktop browser, because it's done over USB.

Privacy and security

Does it send my data anywhere?

No. Your device list stays on the dongle. It only reaches outside your network for the time, a connectivity check and update checks, and none of those carry anything about your devices. The source is public if you want to check.

Is there a login?

No, and it's plain HTTP. Anyone who can reach the dongle can use it, settings included. It's built for a home network where everyone is trusted. Don't put it on a shared or guest network.

Can I reach it from outside my home?

Use a VPN into your network. Never forward a port to it.

Is the password vault safe?

Entries are encrypted with AES-256-GCM, using a key made from your passphrase each time you unlock it. The key is never stored. That protects your logins if someone takes the dongle. It doesn't protect them from someone watching your network traffic, because the dashboard is plain HTTP. SECURITY.md has the full picture.

How it compares

Short, fair summaries. Most of these are excellent at what they do, and several work well alongside LANDA.SH.

LANDA.SHSelf-hosted dashboardsUptime monitorsNetwork scanner apps
ExamplesThisHomepage, Homarr, Dashy, HeimdallUptime KumaFing, Nmap, Angry IP Scanner
Runs onA USB dongleA server or container you runA server or container you runYour phone or computer
Finds devicesYes, all the timeNo; you add each serviceNo; you add each checkYes, when you run a scan
Builds the dashboardYes, one click per tileYou write or arrange itStatus pages you set upNo
Follows IP changesYesYou update the configYou update the checkNot applicable
App widgetsNoYes, often manyNoNo
AlertsIn the dashboardVariesYes, to many servicesVaries

Features of other projects change often; check their own sites for the current picture.

LANDA.SH vs Homepage, Homarr, Dashy or Heimdall

These are self-hosted dashboards: you run them on a server or in Docker, and you tell them what to show, in a YAML file or through a web editor. Some can pick up Docker containers on their own host, and many have rich widgets that pull live numbers from apps like Plex, Sonarr or Pi-hole.

LANDA.SH starts from the other end. It finds what's on the network by itself, including devices that aren't containers at all, like a printer, a NAS's admin page or your router, and it keeps tiles pointing at the right address when an IP changes. It doesn't have app widgets, and it doesn't need a server. If you already run one of these, LANDA.SH is a good way to find out what's on your network that your dashboard doesn't know about.

LANDA.SH vs Uptime Kuma

Uptime Kuma is a monitoring tool. You add each thing to watch, and it tracks uptime in detail and sends alerts to a long list of services. LANDA.SH checks that each dashboard tile answers once a minute and tells you in its notification feed when devices appear, ports open or close, or the internet or DNS goes down. It doesn't send alerts off the dongle. If you need a message on your phone at 3 a.m., use Uptime Kuma.

LANDA.SH vs Fing and other network scanners

Scanner apps like Fing, and tools like Nmap or Angry IP Scanner, show you what's on your network when you run them. LANDA.SH does the same kind of discovery, but it keeps doing it in the background, remembers every device it has seen with the name you gave it, keeps a 24-hour presence history, and turns what it finds into a dashboard you use every day.

LANDA.SH vs your router's device list

Your router knows which devices are connected, but usually not what services they run, and names are often blank or cryptic. It's also the page I got tired of logging into every time I wanted my NAS. LANDA.SH adds names from several sources, open ports, a nickname you choose, and a tile that takes you straight there.

When to use something else

LANDA.SH isn't the right tool if you need:

Try it

It takes about a minute to install from your browser, and it's free.