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.