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

# Setting up Connect on Mac

> Install Digital Florists Connect on an Apple Silicon Mac and run through the first-time setup wizard.

This page walks you through installing **Connect** on a Mac and running the first-time setup wizard. If you're on Windows, see [Setting up Connect on Windows](/get-started/connect-setup-windows) instead.

The whole thing takes about ten minutes, including a few test prints.

## Before you start

You'll need a few things ready:

* **An Apple Silicon Mac running macOS 12 or newer.** Connect is built for M-series chips, so Intel Macs aren't supported.
* **Digital Florists open in your browser.** You'll pair Connect from **Settings** > **Advanced** > **Integrations** > **Connect**, either with a connection link (easiest) or by copying an access token.
* **Your printer powered on** and either on the same network as the Mac, or plugged in by USB.

<Tip>
  Open Digital Florists in a browser on the same Mac you're installing Connect on. The connection link can only open Connect on the computer you click it from.
</Tip>

## Install Connect

<Steps>
  <Step title="Download the installer">
    Go to [downloads.florists.digital](https://downloads.florists.digital) and download the macOS `.dmg`.
  </Step>

  <Step title="Open the disk image">
    Double-click the downloaded `.dmg` file. Finder opens a window with the **Digital Florists Connect** app and a shortcut to your **Applications** folder.
  </Step>

  <Step title="Drag Connect into Applications">
    Drag the **Digital Florists Connect** icon onto the **Applications** folder shortcut. Eject the disk image when it's done.
  </Step>

  <Step title="Launch Connect">
    Open Connect from your **Applications** folder or Launchpad. The setup wizard appears.
  </Step>
</Steps>

The first time Connect runs, macOS may ask for permission to find devices on your local network. Click **Allow** so Connect can discover network printers.

## Setup wizard

When Connect opens, you'll see a welcome screen with a four-step progress bar at the top — **Login**, **Receipt**, **Drawer**, **Label**. Click **Get Started** to begin.

<Steps>
  <Step title="Connect to Digital Florists">
    There are two ways to pair Connect, and both live on the same page in Digital Florists: **Settings** > **Advanced** > **Integrations** > **Connect**.

    **Use the connection link (easiest).** Open that page in your browser and click the connection link. Connect comes to the front and asks you to confirm the shop you're connecting to — click **Connect**. Once it shows **Connected**, the wizard moves straight on to the receipt printer step.

    **Or paste your access token.** Copy the token from the same page, paste it into the wizard, and click **Connect & Continue**. Connect tests the link to your shop and shows a green **Connected** banner with your shop's address.

    Already paired to a different shop? Connect warns you before replacing the connection, and your printer setup is kept. If a connection link won't open or has gone stale, generate a fresh one from the same page in Digital Florists.

    <Info>
      If Connect spots an existing connection from a previous install, it'll skip ahead. Click **Continue to Printer Setup**, or **Use a different instance** to pair fresh.
    </Info>
  </Step>

  <Step title="Choose your receipt printer">
    <Info>
      Before you start, make sure your receipt printer is fully set up following **the manual that came in the box** — unboxed, paper loaded, powered on, and (for network printers) connected to the same network as your computer. Connect can only find printers that are already up and running.
    </Info>

    Connect looks for receipt printers on the till computer and your local network. Each one appears as a card.

    Click **Test Print** on the printer you want to use. A short test slip prints. If it looks right, click **Use This Printer** to save it.

    If your printer doesn't appear, click **Search for Printers** to scan again. For a network printer with a fixed address, click **Enter Network Printer Address** and type in the host and (optionally) a friendly name. Connect tests the connection before saving.

    If you don't have a receipt printer yet, skip this step.

    [Supported receipt printers →](/get-started/connect-receipt-printers)
  </Step>

  <Step title="Test the cash drawer">
    Most cash drawers plug into the receipt printer with the cable that came in the box. Click **Open Drawer** and listen for the click.

    Confirm whether the drawer opened when prompted. Saving routes you on; declining surfaces troubleshooting tips. Common fixes are checking the cable from the drawer to the printer, and making sure the drawer key is in the unlocked position.

    If you don't use a cash drawer, click **Skip — I don't use a cash drawer**.

    [Cash drawer wiring →](/get-started/connect-cash-drawer)
  </Step>

  <Step title="Set up a label printer (optional)">
    Connect now looks for label printers. If yours connects through your operating system's own printer list, add it there first so it appears here automatically.

    For each printer it finds, you can:

    * **Pick the label stock** — choose the roll size loaded in the printer (e.g. 62mm continuous, 102 x 152mm).
    * **Print landscape address labels** — turn this on for our classic landscape delivery-label layout with your logo at the top.
    * **Include your saved business logo** — only shown when landscape labels are on. Prints your saved logo at the top of each label.

    Click **Test Print** to print a sample label. If it looks right, the printer is saved and the wizard moves on.

    If you don't print labels, click **Skip — I don't print labels**.

    [Supported label printers →](/get-started/connect-label-printers)
  </Step>

  <Step title="Finish setup">
    The **Setup complete** screen shows the web address for your POS. Click **Copy** to grab it for your browser's bookmarks or home screen.

    A toggle on the same screen lets the Digital Florists App on phones and tablets reach this computer, with a **Test reachability** check. See [Connect settings](/get-started/connect-settings#companion-app-access) for the detail.

    Click **Finish Setup** to save your choices, then **Open Digital Florists POS** to launch your till.
  </Step>
</Steps>

<Warning>
  Printing from the web app won't work until you click **Finish Setup** on the final step. Closing the wizard before that point leaves your printers unsaved.
</Warning>

Once saved, click **Open Digital Florists POS** to launch your till with Connect ready to print. Connect minimises to your menu bar — you can close the wizard window and Connect keeps running in the background.

<Tip>
  The wizard only toggles whether to include your saved logo — it doesn't upload one. See [Logo and receipt font](/get-started/connect-settings#logo-and-receipt-font) for uploading or changing your logo later.
</Tip>

## Where Connect lives

After setup, Connect runs from the **menu bar** in the top-right of your screen. Click the small Connect icon to open settings, run test prints, or quit the app.

Closing the wizard window doesn't quit Connect — it stays running in the menu bar so the web POS can talk to it. To fully quit, click the menu bar icon and choose **Quit**.

<Tip>
  Connect is set to launch at login by default, so it's ready every time you start your Mac.
</Tip>

## Re-running setup

If you change printers, replace a cash drawer, or move Connect to a different shop, you can run the wizard again at any time.

1. Click the **Connect** icon in your menu bar to open the app.
2. Go to **Settings** > **Printers**.
3. Scroll to **Need to change printers?** and click **Run Setup Wizard Again**.

The wizard reopens from the start. Connect stays paired with your shop, so you can usually skip the connection step and go straight to picking printers.

## Common questions

<AccordionGroup>
  <Accordion title="Will Connect run on an Intel Mac?">
    No. Connect is built for Apple Silicon (M-series) only. If you're on an Intel Mac, you'll need to upgrade your hardware — or run Connect on a Windows PC instead.
  </Accordion>

  <Accordion title="What if I don't have a printer yet?">
    You can skip the receipt printer step in the wizard and finish setup without one. When your printer arrives, open **Settings** > **Printers** in Connect and click **Run Setup Wizard Again** to add it.
  </Accordion>

  <Accordion title="Does Connect need to stay open?">
    Yes, but only in the background. Connect lives in the menu bar and handles printing on demand. You can close the main window — Connect keeps running.
  </Accordion>

  <Accordion title="My printer isn't showing up — what now?">
    Make sure it's powered on and connected. For USB printers, add them through **System Settings** > **Printers & Scanners** first so macOS recognises them. For network printers, click **Search for Printers** to allow the local network scan, or use **Enter Network Printer Address** to add it by IP. If it still won't show up, contact us at [hello@digitalflorists.com](mailto:hello@digitalflorists.com).
  </Accordion>
</AccordionGroup>

## What's next?

<Columns cols={2}>
  <Card title="Printers" icon="print" href="/get-started/connect-printers">
    Supported receipt and label printers, plus how to connect them.
  </Card>

  <Card title="Relay" icon="arrows-rotate" href="/get-started/connect-relay">
    Pull Interflora and eFlorist orders into Digital Florists automatically.
  </Card>

  <Card title="Connect settings" icon="sliders" href="/get-started/connect-settings">
    Tweak Connect's options after setup.
  </Card>
</Columns>
