mayros qr

Generate a QR code and setup code for pairing the Mayros iOS app with your gateway. The QR encodes the gateway URL and authentication credentials into a scannable payload.

Options

OptionDescription
--remoteUse gateway.remote.url and remote token/password (ignores device-pair publicUrl)
--url <url>Override gateway URL in the setup payload
--public-url <url>Override gateway public URL in the setup payload
--token <token>Override gateway token for the setup payload
--password <password>Override gateway password for the setup payload
--setup-code-onlyPrint only the raw setup code (no QR, no metadata)
--no-asciiSkip ASCII QR rendering in the terminal
--jsonOutput JSON with setup code, gateway URL, auth mode, and URL source

Authentication

The setup payload supports two auth modes:

  • Token — uses --token or gateway.auth.token from config
  • Password — uses --password or gateway.auth.password from config

When --remote is set without explicit credentials, the command reads gateway.remote.token or gateway.remote.password from config. You cannot use both --token and --password at the same time.

Pairing workflow

  1. Run mayros qr to display the QR code
  2. Open the Mayros iOS app and go to Onboarding > Scan QR
  3. After scanning, approve the device: 
    bash
    mayros devices list
mayros devices approve <requestId>

Examples

bash
mayros qr
mayros qr --remote
mayros qr --url https://my-gateway.example.com --token my-secret
mayros qr --setup-code-only
mayros qr --json
mayros qr --no-ascii
  • Devices — device management and approvals
  • Pairing — device pairing commands