Overview

The ForsetiDesk mobile app is a native React Native application designed for field technicians. It provides access to assigned tickets, asset lookup, knowledge base articles, parts inventory management, and push notifications — all synchronized with your self-hosted ForsetiDesk server in real time.

Requirements

Installation

iOS

1. Obtain the app via TestFlight (beta distribution) or the App Store (when published).
2. Accept the TestFlight invitation email and tap Install.
3. The app appears on your home screen with the ForsetiDesk icon.

Android

1. Obtain the APK file from your administrator or download from the Play Store (when published).
2. If installing directly from an APK, enable Install from Unknown Sources in device settings.
3. Open the APK file and tap Install.

Login & Server URL

1. Open the app and enter your Server URL — the full address of your ForsetiDesk server including the port if non-standard (e.g., https://desk.yourcompany.com or http://192.168.1.50:4000).
2. Enter your email and password.
3. Tap Sign In. Your session is stored securely using the device's secure keychain and persists across app restarts.

TLS / Self-Signed Certificates

If your server uses a self-signed certificate (not a publicly trusted cert from Let's Encrypt or a CA), mobile devices will reject the connection by default. You must install the ForsetiDesk CA certificate on each device.

iOS

1. On the login screen, tap the Trust Certificate button when the TLS error appears.
2. The app opens the CA certificate download page in Safari.
3. iOS will prompt "This website is trying to download a configuration profile." Tap Allow.
4. Go to Settings → General → VPN & Device Management, find the ForsetiDesk profile, tap Install.
5. Go to Settings → General → About → Certificate Trust Settings, find the ForsetiDesk CA, and enable full trust.
6. Return to the app and log in normally.

Android

1. On the login screen, tap Trust Certificate.
2. The browser opens the CA certificate download page.
3. Android prompts to install the certificate. Tap Install and give it a name (e.g., "ForsetiDesk CA").
4. The certificate is now trusted by the device. Return to the app and log in.

App Navigation Tabs

Ticket Management

The My Work tab shows tickets assigned to the logged-in technician (TECH role) or the tech plus their direct reports (MANAGER role). ADMIN users see all tickets.

Editing Tickets

Tap any ticket to open the detail view with 9 collapsible sections:

• Info (title, status, priority, category)
• Details (description, client info, tags)
• Troubleshooting notes
• Resolution notes
• Internal notes
• Time entries (start/stop timer, add manual entry)
• Linked assets
• Parts used
• Activity history

Routing Actions

Three action buttons appear on ticket detail:

• Escalate — sends a push notification to the tech's manager
• Route to Team — suggests reassignment based on ticket category; notifies the new assignee
• Flag — marks the ticket for dispatcher attention; sends a notification to ADMIN users

Assets & Scanning

The Assets tab lets field techs look up assets by name, asset tag, or serial number. Tap the scan button to use the device camera as a barcode/QR scanner — scan an asset tag to instantly open the asset detail.

Asset detail shows all fields, linked tickets, custom field values, and the CI relationships this asset participates in. Techs can update asset status and notes directly from the mobile app.

Parts Inventory

The Stock tab (Business+) shows all stock locations assigned to the logged-in technician, grouped by location type. Low-stock badges appear on items below the reorder point.

Scanning to Consume

1. Tap the FAB (floating action button) on the Stock tab to open the barcode scanner.
2. Scan a part barcode or type a SKU.
3. If found, a consume form appears inline — enter quantity, select source location, and optionally link to a ticket.
4. Tap Consume. Stock is decremented in real time.

Parts can also be added directly from within a ticket — tap Parts Used → Add Part on the ticket detail screen.

Push Notifications

ForsetiDesk delivers push notifications via Expo Push (FCM on Android, APNs on iOS). Notifications are sent for:

Administrators can enable/disable individual notification types from Admin → Communications → Notifications → Push.

User Management for Mobile

Enabling Mobile Access

By default, all users can use the mobile app. Admins can restrict or revoke mobile access per user:

1. Go to Admin → Users and open the user.
2. Toggle Mobile App Enabled off to prevent the user from logging in via the mobile app.
3. To revoke a specific device session, click Revoke Device Token next to the device in the user detail panel. The device will be signed out on next activity.

MDM / Enterprise Deployment

For organizations deploying ForsetiDesk to many devices via MDM (Mobile Device Management), the app supports pre-configuration via managed app config:

Configure these in your MDM console (Intune, Jamf, Workspace ONE) using the app's bundle ID: com.nilestechnologygroup.forsetidesk.

Role Behavior on Mobile