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

# Set up a Maple kiosk

> Turn an Android tablet or kiosk into a Maple self-order kiosk

The Maple Device app turns an Android tablet or kiosk into a self-order kiosk. Guests order by touch or by voice, and
orders go to your store like any other Maple order.

## What you need

* **A device:** an Android tablet or kiosk unit running Android 8 or newer.
* **Wi-Fi:** a working internet connection at the spot where the kiosk stands.
* **Maple dashboard access** for the store.
* **A printer (optional):** a built-in receipt printer, or an ESC/POS receipt printer on the same network. It takes 58 mm
  or 80 mm paper.

## Turn on the kiosk in Maple

<Steps>
  <Step title="Open Manage Kiosk">
    In the Maple dashboard, go to **Orders** and click **Manage Kiosk**.
  </Step>

  <Step title="Enable the kiosk">
    Click **Enable Kiosk**. You only do this once per store.
  </Step>

  <Step title="Get a pairing code">
    Click **Pair a kiosk**. Maple shows a 6-digit code. Keep the dashboard open; you will type this code on the device.
  </Step>
</Steps>

<Note>
  If you don't see **Manage Kiosk** on the Orders page, [contact Maple](/need-help). Kiosk may not be on for your store
  yet.
</Note>

<Warning>Each code works once and expires after 10 minutes. If it expires, click **Pair a kiosk** again.</Warning>

## Install the Maple Device app

<Steps>
  <Step title="Download the app">
    On the device, open [device-apks.maple.inc/latest.apk](https://device-apks.maple.inc/latest.apk) in the browser.
  </Step>

  <Step title="Open the file">Open the file once it finishes downloading.</Step>

  <Step title="Allow the install">
    When Android asks, allow installs from this source. Android shows this once, because the app does not come from the
    Play Store.
  </Step>

  <Step title="Install and open">Tap **Install**, then **Open**.</Step>

  <Step title="Allow permissions">
    Allow Bluetooth, notifications and the microphone. Guests need the microphone to order by voice.
  </Step>
</Steps>

## Pair the device

<Steps>
  <Step title="Enter the code">
    On the **Pair this device** screen, type the 6-digit code from the dashboard and tap **Pair**.
  </Step>

  <Step title="Choose Kiosk mode">
    The device opens its settings. In the **Mode** card, choose **Kiosk**. Leave **Kiosk address** as it is, then tap
    **Save mode**.
  </Step>

  <Step title="Finish setup">
    The kiosk opens and shows a setup screen with a few checks. Tap **Finish setup and open kiosk**. You only see this
    screen the first time.
  </Step>
</Steps>

Back in the dashboard, the device now shows in the **Devices** list under **Manage Kiosk**, marked **Online**.

## Check the sound

Guests talk to the kiosk, so check that it can hear and be heard.

<Steps>
  <Step title="Open settings">Hold the top-left corner of the screen for 5 seconds, then tap **Open settings**.</Step>

  <Step title="Check the microphone">
    In the **Sound** card, **Microphone** should say **Allowed**. If not, tap **Allow microphone** (or **Open app
    settings** if Android blocked it) and turn it on.
  </Step>

  <Step title="Play a test sound">
    Tap **Test sound**. You should hear three tones from the speaker. If you don't, turn up the call volume and try again.
  </Step>

  <Step title="Go back">Tap **Return to kiosk**.</Step>
</Steps>

## Set up a printer (optional)

<Steps>
  <Step title="Open settings">Hold the top-left corner for 5 seconds, then tap **Open settings**.</Step>

  <Step title="Choose the printer">
    In **Printer settings**, choose **Built-in printer** if the device has one, or **Network printer**. For a network
    printer, enter its IP address under **Address** and leave **Port** at 9100. The printer's self-test slip shows its
    address.
  </Step>

  <Step title="Choose the paper width">Pick **58 mm** or **80 mm** to match the paper roll.</Step>

  <Step title="Save and test">
    Tap **Save settings**, then **Test print**.
  </Step>

  <Step title="Go back">Tap **Return to kiosk**.</Step>
</Steps>

What the test result means:

| Message | What to do |
| - | - |
| **Test ticket sent.** | The printer confirmed. You're set. |
| **Sent to the printer, but it didn't confirm.** | Check that paper came out. If it did, you're set. |
| Any other message | The app says what went wrong. Fix that, then tap **Test print** again. |

## Get back to settings

The kiosk fills the screen, and the Android back button does nothing. To reach settings:

1. Hold the top-left corner of the screen for 5 seconds.
2. Tap **Open settings**.
3. When you're done, tap **Return to kiosk**.

To turn the kiosk back into a ticket printer only, choose **Printer** in the **Mode** card and tap **Save mode**.

## Updates

Small app updates download on their own. The kiosk installs them overnight, between 2 and 5 a.m., so guests are not
interrupted.

Now and then a new version of the app itself comes out. When it does, the settings screen shows **A new version of
Maple Device is ready**. Tap **Download**, open the file, then tap **Install**. Pairing and settings stay as they are.
The notice only shows in settings, never on the kiosk screen guests see, so open settings now and then to check.

## Manage the kiosk from the dashboard

Under **Orders** > **Manage Kiosk**, the **Devices** list shows each paired device with:

* **Online** or **Offline**, and when Maple last heard from it
* Its mode (**Kiosk** or **Printer**), app version and printer status
* The last ticket it printed

Click **Unpair** to remove a device. It stops working until you pair it again with a new code. The same page also sets
the kiosk's colors, idle screen image, welcome message, voice and languages.

## Troubleshooting

<AccordionGroup>
  <Accordion title="No sound">
    Open settings and tap **Test sound** in the **Sound** card. If you don't hear three tones, turn up the call volume
    with the device's volume buttons. If **Microphone** doesn't say **Allowed**, tap **Allow microphone** or **Open app
    settings** and turn the microphone on.
  </Accordion>

  <Accordion title="Pairing code doesn't work">
    Codes work once and expire after 10 minutes. In the dashboard, click **Pair a kiosk** to get a new code, and enter it
    right away. Check that you typed all 6 digits.
  </Accordion>

  <Accordion title="Kiosk shows offline">
    Check that the device is on Wi-Fi and the network has internet access. Open settings: in the **Status** card,
    **Connection** should say **Connected**. The app keeps trying while it's offline, so it reconnects on its own once
    the network is back. If it stays offline, restart the device.
  </Accordion>

  <Accordion title="Printer isn't printing">
    Open settings and tap **Test print**. Check that the printer is on, has paper and is on the same network as the
    device. For a network printer, check the IP address against the printer's self-test slip, and check the port is
    9100\. The **Status** card shows **Out of paper** or **Error** when the printer reports a problem.
  </Accordion>

  <Accordion title="Kiosk screen doesn't load">
    Check the Wi-Fi first. Then open settings and check that **Kiosk address** in the **Mode** card is filled in. Tap
    **Return to kiosk** to try again.
  </Accordion>
</AccordionGroup>

Still stuck? [Contact Maple](/need-help).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.