Settings & Profile

Profile

All users can manage their profile at /profile.

Updating Your Name

1. Open your Profile page (click your avatar in the sidebar or top bar, then Profile).
2. Edit the Full Name field.
3. Click Save Changes.

Your email address is read-only. Contact your administrator to change it.

Changing Your Password

1. Open your Profile page.
2. Scroll to the Change Password card.
3. Enter your Current Password.
4. Enter and confirm your New Password (minimum 8 characters).
5. Click Update Password.

A match indicator shows whether your new password and confirmation match.

Two-Factor Authentication

2FA adds an extra layer of security using a time-based one-time password (TOTP) from an authenticator app.

Enabling 2FA:

1. Open your Profile page.
2. In the Two-Factor Authentication card, click Enable Two-Factor Authentication.
3. Enter your current password to confirm.
4. Scan the QR code with your authenticator app (Google Authenticator, Authy, Microsoft Authenticator, etc.) — or enter the manual key.
5. Enter the 6-digit code from your app to verify.
6. Save your recovery codes — 10 one-time-use codes are shown. Store them securely; they won't be shown again.

Disabling 2FA:

1. Click Disable Two-Factor Authentication.
2. Enter your current password to confirm.

warning

Recovery codes are shown only once when you enable 2FA. If you lose both your authenticator device and recovery codes, contact your administrator for a password reset.

---

Settings (Admin Only)

The Settings page is only available to users with the Admin or Super Admin role.

Samsara Integration

Connect Itinera to your Samsara fleet management account:

1. Enter your Samsara API key.
2. Click Save Key.
3. Click Test Connection to verify — a successful test shows your vehicle and driver counts.

Use Remove Key to disconnect the integration.

Telegram Notifications

Configure automated Telegram alerts for route deviations and low fuel events:

1. Enter the Chat ID for your Telegram group (a negative number for group chats, e.g., -1001234567890).
2. Click Save.
3. Click Send Test Message to verify the connection.

Use Remove to disable Telegram notifications.

tip

To find your Telegram Chat ID, add the Itinera bot to your group and use a bot like @userinfobot or check the Telegram Bot API.

Team Management

Manage your team's access to Itinera:

Adding a User:

1. Click Add User.
2. Fill in: Full Name, Email, and Role (Dispatcher or Admin).
3. A secure password is auto-generated — copy it and share it with the new user.

Generating an Invite Link:

1. Click Generate Invite Link.
2. Optionally pre-fill an email and set an expiry (1, 7, 14, or 30 days).
3. Share the generated link with the new user.

Managing Existing Users:

Click the "..." menu on any user row:

Action	Description
Activate / Deactivate	Toggle a user's access to the platform
Change Role	Switch between Dispatcher and Admin
Reset Password	Generate a new temporary password (shown in a copyable modal)
Delete User	Permanently remove the user account

Invite Link Management

A table below the team list shows all generated invite links with:

• Recipient email (if specified)
• Status: Active, Used, or Expired
• Who created the link
• Who used it (if applicable)
• Creation date

Role Differences

Capability	Dispatcher	Admin
View dashboard, routes, fleet, reports	Yes	Yes
Create and manage routes	Yes	Yes
Access Settings page	No	Yes
Manage team members	No	Yes
Configure Samsara / Telegram	No	Yes
View user filter on Activity Log report	No	Yes