Magic Mirror Quick Start (⏱ 5 min)

Follow these five steps to share a local app with a public URL. No server configs, SSL, or port‑forwarding required.

1. Install the CLI

Grab the installer for your OS from the Downloads page, then verify:

magic-mirror --version

2. Authenticate this device

Log in with your Nodelink account—the CLI will open a browser tab for OAuth and issue an mTLS certificate:

magic-mirror login

3. Start your local app

Run whatever you're building, e.g. a React dev server on localhost:3000:

npm run dev  # or vite, rails s, etc.

4. Connect it to the world

Expose port 3000 with a custom domain in one command:

magic-mirror mirror your-domain.nodelink.ca 3000

The CLI prints a URL like https://your-domain.nodelink.ca. Share it—your app is live!

5. Finish up

When you're done, press Ctrl+C in the terminal.

Explore more commands with magic-mirror --help or dive into the Command Cheatsheet.