Setup Guide

Everything you need to enrol a device and start recording.

Contents
  1. Prerequisites
  2. Create a site
  3. Generate an enrolment code
  4. Install sentry
  5. Pair the device
  6. Start recording
  7. Verify it's working
  8. Troubleshooting
0

Prerequisites

Before you start, make sure you have:

No account yet? Go to the dashboard, enter your phone number, and verify the OTP. Your account is created automatically.
1

Create a site

A site represents a physical store location. Each device binds to a site.

  1. Go to the Sites page in the dashboard.
  2. Click "Add Site".
  3. Enter the store name (e.g. "Downtown Yangon") and select the timezone.
  4. Click Create Site.
2

Generate an enrolment code

The pairing code links a device to your site. Valid for 30 minutes.

  1. Go to the Devices page.
  2. Click "+ Enrol Device".
  3. Select the site you just created from the dropdown.
  4. Click "Generate Code".
  5. Copy the 12-digit code from the popup.
Codes expire after 30 minutes. If yours expires, generate a new one — no harm done.
3

Install sentry

On the mini-PC at the store, install the edge agent and ffmpeg.

Install ffmpeg
sudo apt update && sudo apt install -y ffmpeg
Download sentry (x86_64 — use aarch64-unknown-linux-musl on an ARM box)
wget https://sentry.qikbite.asia/download/latest/x86_64-unknown-linux-musl -O sentry
Verify the checksum against the one shown on the download page
sha256sum sentry
Install
sudo install -m 755 sentry /usr/local/bin/sentry
Verify
sentry version
The binary is called sentry, not sentry-edge. All builds are listed on the download page, including Windows and ARM. The Linux builds are static — nothing else to install.
4

Pair the device

Enrolment binds the device to your site and issues a device token.

Enrol
sentry enrol --code YOUR_12_DIGIT_CODE --cloud-url https://sentry.qikbite.asia

On success you'll see:

Device enrolled successfully: Device ID: dev_xxxxxxxxxx Site ID: site_xxxxxxxxxx Token: dt_xxxxxx...
The device token is written to the config file. You only enrol once per device. Re-enrolling issues a new token and invalidates the old one.
5

Start recording

Once enrolled, configure cameras and start the agent.

Discover and add cameras
sentry discover-cameras --user admin --add

Or add by hand if ONVIF is not available:

sentry add-camera -l "Front Counter" -u "rtsp://user:pass@192.168.1.50/stream2" --main-url "rtsp://user:pass@192.168.1.50/stream1"
-u is the sub-stream (640×360, uploaded and analysed). --main-url is the 2K local evidence buffer (never uploaded). Getting these the wrong way round uploads 4× the expected bandwidth.
Run the agent
sentry run
For production, set up as a systemd service to start on boot. See the deployment guide for the unit file.
6

Verify it's working

Within a few minutes, the device appears in your dashboard.

  1. Go to the Devices page.
  2. You should see your device with an online badge.
  3. Check that the agent version and site are correct.
Or verify from the device
sentry status sentry doctor
The agent uses store-and-forward. If the internet goes down for up to 60 minutes, no video data is lost — it queues locally and uploads when connectivity returns.
7

Troubleshooting

Common issues and how to fix them.

Device shows offline

Check in this order:

  1. Is the mini-PC powered on and connected to the network?
  2. Is the service running?
    sudo systemctl status sentry
  3. Can the device reach the cloud?
    sentry doctor
  4. Check the logs:
    journalctl -u sentry -n 50 --no-pager

Camera not recording

  1. List cameras: sentry cameras
  2. Discover cameras on the network: sentry discover-cameras --user admin
  3. Test with ffmpeg directly: ffmpeg -i "rtsp://..." -frames:v 1 test.jpg

Enrolment fails

Still stuck? Contact support or check the source repository.