← ncdLabs
Meridian
Getting started

Set up Meridian on your desktop

Start with the desktop app on macOS, Windows, or Linux. You can add Meridian Runtime later if you want an always-on, whole-house setup.

Install the app

macOS

  1. Download the DMG from the product page.
  2. Open the disk image and move Meridian to Applications.
  3. Launch Meridian from Applications.

Windows

  1. Download the ZIP from the product page.
  2. Extract the folder to a permanent location.
  3. Run meridian_client.exe from the extracted folder.

Linux

  1. Download the AppImage or DEB from the product page.
  2. AppImage: mark executable, then run it. DEB: install with your package manager.
  3. Launch Meridian from your app menu or the AppImage.

Download Meridian

Connect your first provider

  1. Choose a providerSelect a supported connection such as Home Assistant, Tuya, Amazon Alexa, Arlo Cloud, or local network discovery.
  2. Complete authorizationProvider accounts may open their own sign-in or consent page. Meridian does not receive the password you enter on a provider’s site.
  3. Review what Meridian foundConfirm the rooms, devices, cameras, and controls you want to use.
  4. Try a simple actionCheck state first, then test a low-risk control such as a light or scene.

Standalone or whole-house

One computer

Run Meridian directly on the desktop without a separate server.

Meridian Runtime

Use an always-on computer when you want persistent automation or more Meridian clients on the home network.

Verify your download

Version 0.1.0+4 (macOS) · 0.1.0+3 (Windows/Linux) · macOS universal · Windows x64 · Linux x86_64

macOS DMG SHA-256
a3890112cab80e499635ee95d5dfc6ccea36ab07d6d2464d1e038feb58c9ae19

Linux AppImage SHA-256
52daef79cb03425dcfcbd0640867e80dcdc04c300433bd1ce5120339690e6ef7

Linux DEB SHA-256
1e90cdb776f2dc025c69b2a25e5512b2f69e6382931304933a3516e48d293fec

Windows ZIP SHA-256
6843df5e50124c82fa0de1758f106b853e46b6298301ae4ff893ded62f9340b9

The macOS app inside the DMG was verified as signed by Developer ID Application: Louis Grossi (JGJLGZQT48).

Need help?

Email Meridian support and include the app version, platform, provider, and a short description of what happened. Do not email passwords or access tokens.