Documentation

Managing Devices

Devices are GPS trackers installed in your vehicles. They report location, speed, and other telemetry data to NexaBus. This page lets you add, configure, and monitor all your tracking devices.

Viewing Devices

The Devices table displays the following columns:

• ID: Unique identifier (hidden by default)
• Category: Type of device with icon (car, bus, truck, etc.)
• Name: Your name for the device
• Identifier: Unique ID programmed into the device (IMEI)
• Model: Device model/manufacturer
• Phone: SIM card number in the device
• Status: Enabled or Disabled
• Group: Device group for organization
• Contact: Contact information
• Expiration: Service expiration date
• Sync Status: Real-time connection status with the tracking server

On mobile devices, columns like Phone, Status, Model, Group, Contact, Expiration, and Sync Status are automatically hidden.

Understanding Sync Status

Sync Status shows whether the device is properly connected to NexaBus with real-time updates:

• Syncing: Spinning icon indicates sync in progress (yellow)
• Synced: Check icon confirms device is connected and sending data (green)
• Failed: Error icon indicates connection failed - click to retry (red)

Sync status updates automatically without refreshing the page.

If a device shows "Failed", check that:

• The device is powered on
• The SIM card has data service
• The device is configured with the correct server URL

Filtering by Group

Click the Group column header dropdown to filter devices by group. Select a specific group or "All Groups" to view all devices.

Searching for Devices

Use the search field to find devices. The search works across name, identifier, phone, status, and group name. Results update as you type.

Customizing Columns

1. Click the Columns button above the table.
2. Check or uncheck columns to show or hide them.

Adding a Device

1. Click the Add Device button.
2. Complete the two tabs:

General Tab

• Server URL: The GPS tracker server address (displayed only when creating). Copy this and configure it in your GPS device.
• Name (Required): A friendly name for the device (e.g., "Bus 101 Tracker")
• Identifier (Required): The unique ID from the device (IMEI - usually printed on the device or in its configuration)
• Status: Set to Enabled to start receiving data, or Disabled to stop
• Phone (Required): The SIM card phone number

Details Tab

• Contact: Who to contact about this device
• Model: Device model name
• Category: Type of device - choose from: Default, Animal, Bicycle, Boat, Bus, Car, Camper, Crane, Helicopter, Motorcycle, Person, Pickup, Plane, Ship, Tractor, Trailer, Train, Tram, Truck, Van, or Scooter
• Group: Assign to a device group for organization
• Expiration: When the device service expires

3. Click Create Device.

Important: Copy the Server URL and configure your GPS device to send data to this address. Refer to your device manufacturer's instructions for configuration steps.

Editing a Device

1. Find the device in the table.
2. Click the actions menu (three dots) in that row.
3. Select Edit.
4. Update the information as needed.
5. Click Update Device.

Note: On the free plan, you can only edit your first device. Other devices will show a lock icon. Upgrade your plan to edit all devices.

Deleting a Device

1. Find the device in the table.
2. Click the actions menu (three dots) in that row.
3. Select Delete.
4. Confirm the deletion.

Warning: Deleting a device removes all associated tracking history and stops any vehicles using this device from being tracked.

Retry Sync

If a device shows "Failed" sync status:

1. Click the sync status button, or
2. Open the actions menu and select Retry Sync

The device will attempt to sync again with the tracking server.

Exporting Devices

Click the Export button to download your devices list:

• Excel Export: Downloads an XLSX file with all device information including name, identifier, model, phone, status, category, group, contact, and expiration
• Print: Opens a print-friendly view of the devices table

Device Categories and Icons

Each device category displays with a distinctive icon:

• Car: Car icon
• Bus: Bus icon
• Truck: Truck icon
• Motorcycle: Motorcycle icon
• Person: Person icon (for personal trackers)
• And many more (bicycle, boat, helicopter, plane, etc.)

Pagination

The table displays 10 devices per page. Use the pagination controls at the bottom to navigate:

• First and Last page buttons
• Previous and Next page buttons
• Current page indicator showing "Showing X to Y of Z"

Subscription Limits

Your subscription plan determines how many devices you can add. If you reach your limit, you'll need to upgrade your plan to add more devices.

Permissions

You need the appropriate permissions to add, edit, or delete devices. If these options are not visible, contact your administrator to request access.