Linux server or Raspberry Pi (no Docker)

The installer sets the hub up as a system service on a 64-bit Linux with systemd: Debian, Ubuntu, Raspberry Pi OS (64-bit) and most others.

curl -fsSL https://raw.githubusercontent.com/OpenKedai/openkedai/main/deploy/install.sh | sudo sh

It:

• downloads Node.js 22 (from nodejs.org) and OpenKedai (from the project’s GitHub releases), checking both against their published checksums;
• installs them in /opt/openkedai, with your data in /var/lib/openkedai and settings in /etc/openkedai/openkedai.env;
• creates an openkedai system user and the openkedai service, which starts on boot;
• prints the back office’s address and the setup code.

Then open the address in a browser and choose Set up a new shop.

Everyday commands

sudo systemctl status openkedai          # running?
journalctl -u openkedai -f               # the log
journalctl -u openkedai | grep "Setup code"
sudo nano /etc/openkedai/openkedai.env   # settings, then:
sudo systemctl restart openkedai

Updating

Run the installer again. Your data and settings stay; the previous version is kept in /opt/openkedai/releases/. To install a particular version:

curl -fsSL https://raw.githubusercontent.com/OpenKedai/openkedai/main/deploy/install.sh | sudo OPENKEDAI_VERSION=0.9.0 sh

To go back to the previous version: point /opt/openkedai/app at the other folder in /opt/openkedai/releases/ (sudo ln -sfn /opt/openkedai/releases/<older> /opt/openkedai/app) and restart. An update that changed a shop’s database kept a copy of it first, in /var/lib/openkedai/backups/pre-migration/.

Raspberry Pi

• Use Raspberry Pi OS (64-bit) on a Pi 4 or 5. A 32-bit system isn’t supported.
• SD cards wear out and fail. Turn on copies to S3-compatible storage, or keep the data on a USB SSD.
• At a shop, give the Pi a fixed address in the router: see On the shop’s network.

Uninstalling

sudo systemctl disable --now openkedai
sudo rm -rf /opt/openkedai /etc/systemd/system/openkedai.service /etc/openkedai
sudo userdel openkedai

That leaves your data in /var/lib/openkedai; delete it too once you’re sure you have a copy.