Install a WorkBook server for branches.

Run one command on a Debian or Ubuntu server, or ask us to do it. Then connect each PC and till to the server with a six-digit code.

Updated , for WorkBook 2.0i.

A WorkBook server keeps one set of books for every branch. Every PC and till connects to it over your office network or a VPN. We install it for you if you prefer: write to info@workbook.ae or call +971 56 262 8034.

Before you start.

  • A Linux server running Debian or Ubuntu, with a 64-bit processor, 2 GB of memory and 10 GB of free disk.
  • Your WorkBook licence key, which starts with WB1-.
  • Root access (sudo) on the server.

Steps.

  1. Unpack the WorkBook release on the server.

  2. Run sudo ./deploy/install.sh from the unpacked folder.

  3. Paste your licence key when it asks.

  4. Choose how people reach the server: the office network only, from anywhere through Tailscale, or your own internet address.

  5. Wait for it to finish. It installs what it needs, starts WorkBook and prints a setup link.

  6. Open the setup link on the server (or through an SSH tunnel) and create the owner login and the company.

  7. On each PC, open WorkBook, choose Connect to a Server, pick your server and sign in with your own account.

  8. For a till, add it first under Settings > Tills, then enter its six-digit code on that computer under Settings > This Device.

Good to know.

  • Keep a copy of the file deploy/docker/.env somewhere else. Backups cannot be restored without it.
  • With the office-network choice, each PC's browser needs the certificate file deploy/docker/workbook-root.crt installed once. The WorkBook app on Windows does not.
  • If the owner chooses it under Settings > Devices, a new computer needs a one-time code that lasts 10 minutes.
  • Running the installer again on an installed server stops. To update, unpack the new release and run its deploy/upgrade.sh.

Related.