> Tillcast is live: the API at https://api.tillcast.com/v1 and the dashboard at https://dashboard.tillcast.com. A key prints on real printers, so do not call the API unless asked. A job carries its receipt as "document", an array of blocks (the recommended way), or as "receiptline", ReceiptLine text, exactly one of the two: read https://docs.tillcast.com/create-a-print-job.md and https://docs.tillcast.com/concepts/documents.md before you write a job body. Do not code against what does not exist yet: webhooks, a template language, stored templates (a job has no template field), OAuth connections and connectors for Make, Zapier and n8n, and OAuth sign-in for the MCP server. SDKs for TypeScript (@tillcast/sdk, version 0.2.0 or later for blocks) and Python (tillcast) exist as pre-1.0 versions. To show a receipt in a web page without printing, there are the npm packages @tillcast/preview and @tillcast/html-render (0.x, no API key, no call to Tillcast to draw): read https://docs.tillcast.com/preview-a-receipt.md. The docs are the source of truth: check the index https://docs.tillcast.com/llms.txt and https://docs.tillcast.com/roadmap.md before you code against anything. For clean Markdown of any page, append .md to the page URL. The Tillcast MCP server is live at https://api.tillcast.com/mcp and takes an API key as a bearer token (setup: https://docs.tillcast.com/connect-an-ai-assistant.md). It acts on the live account and its tools print on real paper, so do not connect to it or call its tools unless the owner asked you to. The MCP server at https://docs.tillcast.com/_mcp/server is a different one: it only searches these docs and cannot call the Tillcast API.

# Printer setup checklist

> A short checklist for installing a Star or an Epson printer with a Tillcast printer URL.

A Star printer with CloudPRNT and an Epson printer with Server Direct Print are supported. See [Supported printers](/printers/supported-printers) for the models and for what has run on a device. The full steps are in [Set up a Star printer](/printers/star-setup) and [Set up an Epson printer](/printers/epson-setup).

## Before the visit

* [ ] The printer model supports CloudPRNT (Star) or Server Direct Print (Epson). On Star mC-Print models use firmware 3.2 or newer.
* [ ] The printer was added by its paper width, and Tillcast reads its maker when it first connects. Or it was added with the right maker named: Star, or Epson. A named maker cannot be changed afterwards.
* [ ] The paper width is right, or the printer has the [profile](/printers/profiles) of its paper. A 58 mm printer needs a 58 mm profile.
* [ ] You have the [printer URL](/concepts/printer-url) for this exact printer. It is shown once.
* [ ] The venue network allows outgoing HTTPS (port 443) and DNS. No VPN, port forwarding or local server is needed.
* [ ] A computer on the same network as the printer.

## At a Star printer

* [ ] Print the self-test page and note the IP address and firmware version.
* [ ] Open `http://<printer-ip>/` and change the web admin password if it is still the factory default.
* [ ] Enable CloudPRNT in HTTP mode.
* [ ] Paste the whole printer URL into the **Server URL** field. It starts with `https://`. No trailing slash, no spaces.
* [ ] Leave username and password empty.
* [ ] Set the polling time to 5 seconds.
* [ ] Leave MQTT off.
* [ ] Check the printer's date and time.
* [ ] Save, then restart the printer.

## At an Epson printer

* [ ] Open the printer's Web Config at `http://<printer-ip>/` and log in as administrator.
* [ ] Check the printer's date and time.
* [ ] Open **TM-i Settings**, then **Server Direct Print**, and enable it.
* [ ] Paste the whole printer URL into **Server1**, **URL**. No trailing slash, no spaces.
* [ ] Set **Interval(s)** to 5. Leave **ID** and **Password** empty.
* [ ] Set **Server Authentication** to Enable, and check that **ePOS-Print** reads Enable.
* [ ] Press **Apply & Restart**.

## After the restart

* [ ] In the dashboard the printer's status turns from **Never connected** to **Online**. Reload the page.
* [ ] A Star prints the welcome receipt. See [First connection](/printers/first-connection). An Epson prints none.
* [ ] An Epson added by its paper width: its page says **Check the line width**. Press **Print calibration sheet** and type the code under the longest ruler that stays on one line, or set its profile through the API. See [Set up an Epson printer](/printers/epson-setup#step-4-check-the-line-width).
* [ ] The location and printer names on the receipt are the right ones.
* [ ] Press **Test print** on the printer's page, or send a test job from your software.
* [ ] Keep the printer URL out of tickets, chat and source code.

If something fails, go to [Troubleshooting](/printers/troubleshooting).