Preset: Starter Kit {#starter}

Best for small offices or single rooms up to 500 sqm. Quick to set up, minimal hardware required.

What you'll get:

• Real-time location of tracked assets/people
• Web-based map visualization
• Zone-based or triangulation positioning

Coverage: Up to 500 sqm · 2km LoRaWAN range

Step 1: Deploy BLE Beacons {#beacons type=manual required=true}

Place BLE beacons at fixed locations around your space as position reference points.

Wiring

1. Place at least 3 beacons per area (triangulation) or 1 beacon (proximity)
2. Install at 2.5-3m height, 10-15m spacing
3. Record each beacon's MAC address and location

Troubleshooting

Step 2: Setup LoRaWAN Gateway {#gateway type=manual required=true}

Connect the gateway to enable wireless communication between tracker and positioning app.

Wiring

1. Power on gateway, connect to network (Ethernet or WiFi)
2. Use SenseCraft App to scan QR code and bind gateway
3. Solid green LED indicates ready

Troubleshooting

Step 3: Deploy Positioning Application {#app_server type=docker_deploy required=true config=devices/app_local.yaml}

Target: Local Deployment {#app_server_local type=local config=devices/app_local.yaml default=true}

Deploy the indoor positioning application on your local computer.

Wiring

1. Ensure Docker Desktop is installed and running
2. Ensure port 5173 is available

Deployment Complete

1. Visit http://localhost:5173, login with admin / 83EtWJUbGrPnQjdCqyKq
2. Upload floor map, mark beacon positions on map (enter MAC addresses)
3. Configure LoRaWAN network server webhook to http://your-local-ip:5173/api/webhook

Troubleshooting

Target: Remote Deployment {#app_server_remote type=remote config=devices/app_remote.yaml}

Deploy the indoor positioning application to a remote server via SSH.

Wiring

1. Connect target device to network
2. Get device IP address
3. Get SSH credentials (username/password)
4. Ensure Docker is installed on the remote server

Deployment Complete

1. Visit http://<device-ip>:5173, login with admin / 83EtWJUbGrPnQjdCqyKq
2. Upload floor map, mark beacon positions on map (enter MAC addresses)
3. Configure LoRaWAN network server webhook to http://<device-ip>:5173/api/webhook

Troubleshooting

Step 4: Configure and Activate Tracker {#tracker type=manual required=true}

Set up the tracker and test positioning accuracy by walking near the installed beacons.

Wiring

1. Press power button 3s to turn on, blinking green = joining network
2. Use SenseCraft App to connect to tracker
3. Set mode to "BLE Scan", select correct LoRaWAN region
4. Walk near beacons, press button to trigger report, verify positioning works

Troubleshooting

Preset: Standard Setup {#standard}

Best for medium facilities (500-2000 sqm) like warehouses, offices, or retail stores.

What you'll get:

• Real-time location of tracked assets/people
• Multi-zone coverage with meter-level accuracy
• Web-based map visualization with history

Coverage: Up to 2000 sqm · Multiple rooms/floors supported

Step 1: Deploy BLE Beacons {#beacons type=manual required=true}

Place BLE beacons at fixed locations around your space as position reference points.

Wiring

1. Place at least 3 beacons per area (triangulation) or 1 beacon (proximity)
2. Install at 2.5-3m height, 10-15m spacing
3. Record each beacon's MAC address and location

Troubleshooting

Step 2: Setup LoRaWAN Gateway {#gateway type=manual required=true}

Connect the gateway to enable wireless communication between tracker and positioning app.

Wiring

1. Power on gateway, connect to network (Ethernet or WiFi)
2. Use SenseCraft App to scan QR code and bind gateway
3. Solid green LED indicates ready

Troubleshooting

Step 3: Deploy Positioning Application {#app_server type=docker_deploy required=true config=devices/app_local.yaml}

Target: Local Deployment {#app_server_local type=local config=devices/app_local.yaml default=true}

Deploy the indoor positioning application on your local computer.

Wiring

1. Ensure Docker Desktop is installed and running
2. Ensure port 5173 is available

Deployment Complete

1. Visit http://localhost:5173, login with admin / 83EtWJUbGrPnQjdCqyKq
2. Upload floor map, mark beacon positions on map (enter MAC addresses)
3. Configure LoRaWAN network server webhook to http://your-local-ip:5173/api/webhook

Troubleshooting

Target: Remote Deployment {#app_server_remote type=remote config=devices/app_remote.yaml}

Deploy the indoor positioning application to a remote server via SSH.

Wiring

1. Connect target device to network
2. Get device IP address
3. Get SSH credentials (username/password)
4. Ensure Docker is installed on the remote server

Deployment Complete

1. Visit http://<device-ip>:5173, login with admin / 83EtWJUbGrPnQjdCqyKq
2. Upload floor map, mark beacon positions on map (enter MAC addresses)
3. Configure LoRaWAN network server webhook to http://<device-ip>:5173/api/webhook

Troubleshooting

Step 4: Configure and Activate Tracker {#tracker type=manual required=true}

Set up the tracker and test positioning accuracy by walking near the installed beacons.

Wiring

1. Press power button 3s to turn on, blinking green = joining network
2. Use SenseCraft App to connect to tracker
3. Set mode to "BLE Scan", select correct LoRaWAN region
4. Walk near beacons, press button to trigger report, verify positioning works

Troubleshooting

Preset: Enterprise {#enterprise}

Best for large facilities (2000+ sqm) like factories, hospitals, or campus buildings.

What you'll get:

• Campus-wide real-time tracking
• High-precision triangulation positioning
• Scalable to thousands of tracked assets

Coverage: 2000+ sqm · Add gateways for multi-building coverage

Step 1: Deploy BLE Beacons {#beacons type=manual required=true}

Place BLE beacons at fixed locations around your space as position reference points.

Wiring

1. Place at least 3 beacons per area (triangulation) or 1 beacon (proximity)
2. Install at 2.5-3m height, 10-15m spacing
3. Record each beacon's MAC address and location

Troubleshooting

Step 2: Setup LoRaWAN Gateway {#gateway type=manual required=true}

Connect the gateway to enable wireless communication between tracker and positioning app.

Wiring

1. Power on gateway, connect to network (Ethernet or WiFi)
2. Use SenseCraft App to scan QR code and bind gateway
3. Solid green LED indicates ready

Troubleshooting

Step 3: Deploy Positioning Application {#app_server type=docker_deploy required=true config=devices/app_local.yaml}

Target: Local Deployment {#app_server_local type=local config=devices/app_local.yaml default=true}

Deploy the indoor positioning application on your local computer.

Wiring

1. Ensure Docker Desktop is installed and running
2. Ensure port 5173 is available

Deployment Complete

1. Visit http://localhost:5173, login with admin / 83EtWJUbGrPnQjdCqyKq
2. Upload floor map, mark beacon positions on map (enter MAC addresses)
3. Configure LoRaWAN network server webhook to http://your-local-ip:5173/api/webhook

Troubleshooting

Target: Remote Deployment {#app_server_remote type=remote config=devices/app_remote.yaml}

Deploy the indoor positioning application to a remote server via SSH.

Wiring

1. Connect target device to network
2. Get device IP address
3. Get SSH credentials (username/password)
4. Ensure Docker is installed on the remote server

Deployment Complete

1. Visit http://<device-ip>:5173, login with admin / 83EtWJUbGrPnQjdCqyKq
2. Upload floor map, mark beacon positions on map (enter MAC addresses)
3. Configure LoRaWAN network server webhook to http://<device-ip>:5173/api/webhook

Troubleshooting

Step 4: Configure and Activate Tracker {#tracker type=manual required=true}

Set up the tracker and test positioning accuracy by walking near the installed beacons.

Wiring

1. Press power button 3s to turn on, blinking green = joining network
2. Use SenseCraft App to connect to tracker
3. Set mode to "BLE Scan", select correct LoRaWAN region
4. Walk near beacons, press button to trigger report, verify positioning works

Troubleshooting

Deployment Complete

Indoor positioning system is ready!

Access Your System

• URL: http://<server-ip>:5173
• Login: admin / 83EtWJUbGrPnQjdCqyKq

Initial Setup

1. Upload your floor map image
2. Mark beacon positions on the map (enter MAC addresses)
3. Configure LoRaWAN network server webhook

Quick Verification

• Walk near beacons with tracker
• Press tracker button to trigger position report
• Check web dashboard for real-time location updates

Next Steps

• View Wiki Documentation
• GitHub Repository
• Try Online Demo