Skip to content
Infotech

Set up the agent

  1. In the back office, open Restaurant Management › Kitchen printers. Add the printers with the connection Network and their IP address. The address is on the printer's self-test page: hold the feed button while switching it on.

  2. Under Print agents, choose New agent key and copy the key. It is shown only once.

  3. On the computer, run:

    POS_SERVER=https://pos.example.com POS_AGENT_KEY=pa_… node src/agent.mjs
    

    Instead of the environment variables, you can copy config.example.json to config.json and fill it in. That file is ignored by git, so keep the key there and nowhere else.

  4. Press Test on a printer. The page should print within a second or two.

SettingMeaning
POS_SERVERThe POS address, https://…
POS_AGENT_KEYThe agent key (pa_…)
POS_ENCODINGascii (default), or utf8 for printers set to UTF-8. Then Arabic names print too

Last updated 10 Oct 2026