Aantar

Aantar POS

The chain's store server in the cloud

Start the chain's one store server in Docker on a cloud computer with a public name, then make the chain's one company on its set-up page.

The chain's store server is the Docker store server on a computer in the cloud. Every till of every store reaches it over the internet, so it needs a fixed public name and one open port. The person who sets it up needs to be at ease with a Linux command line for the first start; everything after that is done on the set-up page in a browser.

Before you start

  • A Linux computer (a VM) at a cloud provider, with Docker and Docker Compose.
  • A fixed public name for it, for example pos.yourchain.ca, pointing at the VM.
  • The Store Server Docker image and compose.store.yaml from Aantar One Inc..
  • A Aantar POS licence key covering every lane of every store. See How a chain is set up.

Steps

  1. Load the image on the VM: docker load -i aantar-pos-store-server-docker.tgz.
  2. In compose.store.yaml, set:
  • STORE_ADDRESS to the public name, for example pos.yourchain.ca. If the tills reach the server on another port than 47810, add it after a colon. The pairing link carries this name; without it the server makes no link.
  • STORE_NAME to the name the tills show.
  • STORE_TZ to America/Vancouver for a chain in British Columbia.
  • STORE_DATA to a folder on the VM's own disk, or keep the named volume store-data. Never a network share.
  1. In the cloud provider's firewall, open TCP port 47810 (or the port you chose) to the internet. The server speaks HTTPS only.
  2. Start it: docker compose -f compose.store.yaml up -d.
  3. Read the set-up code from the log: docker compose -f compose.store.yaml logs host.
  4. From the head office, open https://pos.yourchain.ca:47810/setup. The browser warns about the server's own certificate: continue. (The tills do not trust it by name; they check its fingerprint when they pair.)
  5. Type the Set-up code and the new admin password, and press Set the password.
  6. Under Licence, give the key file or paste the key, and press Activate the licence.
  7. Under 2. Companies, open Make a company on this server and make one company: its name, Kind of business (for example liquor or convenience), Province or territory British Columbia, the owner's name, and the admin user name and password. Press Make the company.
  8. Write down the recovery key shown once, and press I have written it down.

The page makes the books, the BC taxes, deposits and recycling fees, the departments, reason codes and the preset items and promotions of the kind you chose. The company's first location is the first store.

Important: Anyone who can reach the set-up page can try the admin password. Use a long password, keep it in a sealed envelope at head office, and set it the moment the server starts: until then, the set-up code in the log is all that protects the page.

Not finished: A chain on one store server has been proved by a test with every store and lane on one PC, not yet on a cloud computer over the real internet. See What is proved and what is not.

Backups

  • The server backs the company up after Zs and at least once a day, into the Backups folder of its data folder. See Automatic backups.
  • On the set-up page, 5. Backups sets a second place and how many copies are kept. See Keep a copy in a second place.
  • Also snapshot the VM's disk or the Docker volume with the cloud provider's own tool.

Note: Aantar One Inc. also sells hosting of the store server as a separate add-on, sold through Aantar Cloud. See The Store Server add-on and cloud hosting.

If something goes wrong

  • No pairing link on the set-up page: STORE_ADDRESS is empty or wrong. Set it and run docker compose -f compose.store.yaml up -d again.
  • The tills cannot reach the server but the head office can: check the cloud firewall for port 47810, and that the stores' own firewalls let HTTPS out on that port.
  • The company shows Locked after a restart: it has a company file password. Unlock it under 2. Companies. See The set-up page.

Related articles

Something unclear or out of date? Write to support@aantar.com and name this page.