Run using docker-compose

This section demonstrates how to install the nutrix service using docker-compose.

TIP

On windows make sure WSL2 is installed before proceeding.

INFO

Make sure that git , docker and docker-compose are installed

1. Clone the pos repo & run docker compose

git clone https://github.com/nutrixpos/pos.git
cd pos
docker-compose up --build -d

2. Configure autostarting

INFO

For Windows users !

Enable systemd in wsl config

vim /etc/wsl.conf

[boot]
systemd=true

You will then need to close the Linux distribution. You can use the command wsl.exe --shutdown in PowerShell to restart all WSL instances.

Once your Linux distribution restarts, systemd will be running. You can confirm using the command: systemctl list-unit-files --type=service, which will show the status of any services associated with your Linux distribution.

for more info refer to WSL Systemd

Create systemd unit files

sudo nano /etc/systemd/system/nutrix.service

[Unit]
Description=My Docker Compose Service
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/path/to/your/pos_repo
ExecStartPre=/usr/bin/docker-compose down
ExecStart=/usr/bin/docker-compose up -d
ExecStop=/usr/bin/docker-compose down
Restart=no

[Install]
WantedBy=multi-user.target

TIP

Make sure you change /path/to/your/pos_repo in the above file to the pos repo path on your machine

Enable and start the service

sudo systemctl enable nutrix.service
sudo systemctl start nutrix.service

3. Open nutrix console

Open nutrix console at http://localhost:3000