> ## Documentation Index
> Fetch the complete documentation index at: https://help.ondeckapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick start: install Relay and build your first dashboard

> Open Relay, create a dashboard, add a tile and module, and enter Live Mode.

This guide walks you through Relay from first launch to running your first live dashboard.

<Steps>
  <Step title="Open Relay">
    Launch Relay on your Mac. If macOS asks for permissions, allow the prompts that match the workflows you plan to use.

    <Tip>
      Relay may need Local Network, Microphone, or Speech Recognition access depending on which modules or integrations you use. You can review permission status at any time in `Relay > Settings > Access`.
    </Tip>
  </Step>

  <Step title="Create a new dashboard">
    Choose `File > New Dashboard`. If prompted, choose a canvas size that fits your display or planned operating view.

    Save the dashboard early with `File > Save Dashboard` or `Command-S` so you have a real `.relay` file before you build further.
  </Step>

  <Step title="Add a tile">
    In Canvas View, use the toolbar to add a tile. Drag it into position and resize it until it feels readable for the actual distance where it will be used.
  </Step>

  <Step title="Add a module">
    Select the tile, open the add-module control, and choose a module such as Time, Text, Document, Webpage, Planning Center, or ProPresenter.

    <Note>
      Some advanced modules and workflows require Relay Pro. If something appears locked, review your status in `Relay > Settings > License`.
    </Note>
  </Step>

  <Step title="Configure the connections you need">
    Open `Relay > Settings` and connect only the systems you actually plan to use first, such as Planning Center, ProPresenter, devices, OSC, MIDI, or LAN sharing.
  </Step>

  <Step title="Enter Live Mode">
    Choose `View > Live Mode` or use `Command-L` when the dashboard is ready for production use.
  </Step>
</Steps>

## Troubleshooting

If a feature does not work after granting a permission, quit and reopen Relay. If live data still does not appear, confirm the integration is configured in settings and that the target system is reachable on the network.