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

# Print Jobs and Printer Setup on the ePOS App

> Monitor cloud and local print jobs, retry failures, and configure receipt printers directly from the oFatoura waiter app on your device.

The Print Jobs screen lets you see the full print history for your device — both jobs sent from the server and jobs queued locally on the device. From the same Settings area you can add new printers, check their reach, and run diagnostics without touching the web admin.

<Note>
  You need the **View Print Jobs** permission to access the Print Jobs screen. Contact your manager if the screen is not visible on your device.
</Note>

## The Print Jobs screen

Open the Print Jobs screen from the main navigation (POS screen > Print Jobs).

The screen is split into two tabs:

| Tab       | What it shows                                                                                                |
| --------- | ------------------------------------------------------------------------------------------------------------ |
| **Cloud** | Jobs created by the oFatoura server — receipts, KOTs, and reports triggered from any device or the web admin |
| **Local** | Jobs queued directly on this device, managed by the on-device print coordinator                              |

Each job card shows:

* Order number and timestamp
* Printer name and target device
* Job size and retry count
* **Status:** Pending, Printing, Processing, Completed, or Failed

### Retrying a failed local job

<Steps>
  <Step title="Switch to the Local tab">
    Tap **Local** at the top of the Print Jobs screen.
  </Step>

  <Step title="Find the failed job">
    Failed jobs are labelled **Failed** in red. Tap the job to see its details, including the retry count.
  </Step>

  <Step title="Retry">
    Tap **Retry** on the job detail. The job is requeued immediately on this device.
  </Step>
</Steps>

<Tip>
  If a job fails repeatedly, check that the printer is powered on and reachable before retrying. See [Printer Setup in Settings](#printer-setup-in-settings) below.
</Tip>

### Clearing local print history

To remove all completed and failed local jobs from the list, tap **Clear history** on the Local tab. This only clears the history on this device — it does not affect cloud jobs or any other device's records.

<Warning>
  Clearing local history is permanent. If you need a log of all print activity for reporting, use the web admin's print log report instead. See [Attendance, Expense, and Print Log Reports](/reports/operational-reports).
</Warning>

***

## Printer setup in Settings

Open **Settings** (app bar or left menu) and scroll to the **Printers** section.

### Adding a printer

You can add a printer two ways:

<Tabs>
  <Tab title="Scan for nearby printers">
    <Steps>
      <Step title="Tap Scan for nearby printers">
        The app searches the local network for discoverable printers. This works when the device and printer are on the same Wi-Fi network.
      </Step>

      <Step title="Select the printer from the list">
        Tap the printer you want to add.
      </Step>

      <Step title="Confirm the transport">
        The app pre-fills the connection type. Confirm and save.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Add manually">
    <Steps>
      <Step title="Tap Add printer manually">
        Enter the printer's details directly.
      </Step>

      <Step title="Enter connection details">
        Fill in the printer name, IP address (for LAN/TCP), USB port, or spooler queue name depending on the transport you choose.
      </Step>

      <Step title="Choose the transport type">
        Select one of:

        * **LAN (TCP)** — network printer reachable by IP address
        * **USB** — printer connected directly to this device via USB
        * **Windows Spooler** — printer shared through a Windows print queue on the network
      </Step>

      <Step title="Save">
        Tap **Save**. The printer appears in your printer list.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Printer reach matrix

The reach matrix lets you control which devices can send jobs to which printers. After adding a printer, tap it to open its settings, then review the **Reach** section. Toggle each device on or off to set whether this device is allowed to print to that printer.

Use this when you have multiple devices in a branch and want to restrict, for example, the bar printer to only the bar tablet.

### Printer diagnostics (v4)

In the Printers section of Settings, tap **Diagnostics** (or the diagnostics icon next to a printer) to see the current status of the on-device print stack. The diagnostics view reports whether the print coordinator is running, the queue depth, and any error codes from the last attempted job. This is useful when jobs are silently not printing and you want to confirm whether the issue is on the device or the printer itself.

***

## Developer option: disable printing from this device

<Warning>
  This option is intended for technical troubleshooting only. Enabling it stops all local print jobs from being dispatched from this device.
</Warning>

In **Settings**, scroll to **Developer options** and toggle **Disable printing from this device**. When enabled, the device stops sending any local print jobs. Cloud jobs are unaffected — they are dispatched by the server and handled by whichever device claims them. Disable this toggle again to resume normal printing.

***

## Related

* [Receipts and Printing Basics](/essential-setup/receipts-and-printing-basics)
* [Printer Configuration and Devices](/settings/printers-and-devices)
* [Attendance, Expense, and Print Log Reports](/reports/operational-reports)
* [ePOS App Settings and Manager Overrides](/epos-app/settings-and-overrides)