Skip to content

Troubleshooting DriveFlow Mobile

Applies to: Owner and other school staff, Instructor, Student. Last reviewed: 2026-11-18.

Every message quoted here is the app's or the server's real wording. Find the message you see, or the problem you have, and follow the steps.

Messages that can appear on any screen

Message What it means What to do
"We can't reach DriveFlow. Check your internet connection and try again." The phone could not connect to the server Check mobile data or Wi-Fi, then tap Try again or reopen the screen
"DriveFlow took too long to respond. Please try again." No answer within 30 seconds Try again; move to a better signal
"DriveFlow couldn't complete that just now. Please try again shortly." The server had a problem, or sent something the app did not expect Wait a minute and try again. If it keeps happening, tell your school and quote the app version
"Your session has ended. Please sign in again." Your session ran out or was refused Sign in again. See Session management
"You don't have access to this. Please ask your school's administrator." Your role lacks the permission Ask the school to check your role
"This record no longer exists." The item was deleted, or is not yours to see Go back and refresh the list
"<Feature> is not included in your <plan> plan. Upgrade your plan under Settings > Subscription to use it." The school's plan lacks a feature this screen needs The owner upgrades the plan
"<Feature> is a paid add-on. Activate or renew it under Settings > Billing to use it." An add-on has lapsed The owner renews it on the web

I cannot sign in

What you see Cause Fix
"The email address or password is incorrect. New to DriveFlow? Register your school below." Wrong password, wrong email, or the account has been deactivated Check the email address. Tap Show to check the password. Use Forgot password?. If it still fails, ask your school whether your account is active
"Too many failed sign-in attempts. Please try again in N minutes." The account is locked after repeated wrong passwords Wait the time shown. A correct password will not work until then
"Your driving school's DriveFlow plan doesn't include the mobile app yet. Please contact your school to get access." Your school's plan does not include the app See Not included in your plan
"Please enter a valid email address and password." The server rejected what was typed Retype both
It works on the website but not in the app The plan includes the web but not the app, or the phone has no connection Check the message shown; see the rows above
No mobile access screen Your account has no role Ask your school to give your account a role
I never received the reset email The address has no account, or the email is in spam. The app shows the same confirmation either way Check spam; check the address with your school
I was sent to Choose your password You signed in with a temporary password Enter the temporary password and choose your own. See Authentication

The app says my school's plan does not include it

Screen Who sees it Fix
Message on the Sign in screen Staff and students who cannot change the plan Ask the school's owner to upgrade to Professional or higher. Then sign in again
Upgrade to use DriveFlow Mobile The owner (anyone who can manage the subscription) Tap View plans and upgrade and follow Upgrading from the phone
Mobile app not available Someone already signed in when the plan changed Ask the owner to upgrade. Reopen the app afterwards; you do not need to sign in again
We couldn't check your access Anyone, when the plan could not be checked Check your connection and tap Try again

After paying on PayFast

Tap I've paid, check again. "We haven't received confirmation of the payment yet. PayFast can take a minute; please try again shortly." means the payment has not been confirmed to DriveFlow yet. Wait and tap again.

If the subscription has ended, the result is the same: the owner renews, everyone else waits.

A blank or stuck screen when the app starts

What you see Cause Fix
A white screen for a moment, then the app Normal. Nothing is drawn until the saved session and the plan have been checked Wait a few seconds
"Loading..." that does not go away The app's screens did not start Close the app completely and open it again. Update the app. If it persists, uninstall and reinstall
A yellow bar "An unhandled error has occurred. Reload" An error the app did not handle Tap Reload. If it returns, note what you were doing and report it with the app version
The app closes immediately on start, every time A fault in that build. Version 1.0 (6) had exactly this: the Release build removed something the secure storage needs, so every start failed while restoring the session. It was fixed in the build that followed Update to the latest version
Signed out after every restart although Remember me was ticked The phone's secure storage could not save or read the session The app keeps working but cannot remember you. Restart the phone; reinstall the app if it continues
Sign-in screen after restoring the phone from a backup The saved session cannot be decrypted on a different phone Sign in again; this is expected

For developers: warnings, errors and unhandled exceptions are written to the Android device log under the tag DriveFlow, in Release builds too. See Technical notes (internal documentation).

I am not getting push notifications

Work down this list:

  1. Are you a student or an instructor? Push notifications are currently sent only to students and instructors. Other staff do not receive them.
  2. Android only. There is no push on other platforms.
  3. Settings › Push notifications must be ticked.
  4. If Settings shows "Notifications are blocked for DriveFlow on this phone.", tap Open phone settings and allow notifications. Also check the Lesson updates channel is not silenced.
  5. Sign out and sign in again with a working connection. The phone registers at sign-in.
  6. Instructors: your account must be linked to your instructor profile. Open My Lessons once; if you see "Your account isn't linked to an instructor profile…", ask the school to fix the email on your profile.
  7. Ask your school to check that notifications are active and that the event is enabled (website or app: Settings › Notifications), and that it is not being held by quiet hours.
  8. The school's plan must include the Mobile App feature.
  9. The server must have push configured. If nobody at any school receives push, push is probably not configured on the server. Contact DriveFlow support.

The school can see whether a push was sent in its notification log: a push appears with the recipient "DriveFlow app (N devices)".

Lesson reminders do not appear

  • Reminders are for students only.
  • Settings › Lesson reminders must be ticked.
  • Android must allow notifications for DriveFlow.
  • Reminders are set when the Student Dashboard loads. Open the dashboard after a lesson is booked or changed.
  • Only the next 10 lessons get reminders.
  • Some phones delay alarms for apps under battery saving. Exclude DriveFlow from battery optimisation in the phone's settings.
  • A reminder for a lesson the school has since moved or cancelled can still fire if you have not opened the app since.

Lessons, booking and sign-off

Message Who Fix
"Your account isn't linked to an instructor profile. Ask your school to check that your instructor profile uses the same email address as your DriveFlow account." Instructor The school makes the two email addresses match
"More than one instructor profile at your school uses your email address. Ask your school to correct the instructor profiles." Instructor The school removes the duplicate
"This lesson isn't one of yours, or it no longer exists." Instructor The lesson belongs to someone else or was removed
"Start the lesson before signing it off." Instructor Open the lesson and tap Start lesson first
"This lesson is awaiting your sign-off. Start it from the lesson page before signing off." with no Start button Instructor The lesson has status Awaiting Instructor Sign-off, which no screen in the application sets (only a direct data change can cause it). Finish it on the website; see Instructor features
"Please sign in the box." Instructor, Student Draw a signature. If you rotated the phone, the box was cleared
"… signature must be a PNG image." / "… signature is too large." Instructor, Student Tap Clear, sign again and resend. If it repeats, update the app
"No free times on these days. Try later dates." Student Move a week ahead, or tick Any free instructor
"Online booking isn't available at your driving school. Please contact them to book a lesson." Student The school has not opened online booking
A red message after sending a request Student The time was just taken; pick another
"This lesson has already started." Student Too late to confirm, change or cancel in the app; phone the school
"This lesson isn't waiting for your signature." Student The instructor has not signed yet, or the lesson is already complete
"Only a request that is still waiting for the school can be withdrawn." Student The school has already answered

Payments and documents

Message Fix
"The document couldn't be opened. Is there a PDF viewer on this device?" (also "The invoice…", "The receipt…", "The file…") Install a PDF viewer (or a spreadsheet app for Excel exports) and try again
"The payment page couldn't be opened." Install or enable a browser. Pay on the web portal instead
"Online payments aren't available at your driving school. Please contact them to pay." Pay the school directly
Paid on PayFast but the balance is unchanged Tap I've paid, refresh again after a minute. A payment counts only when PayFast confirms it to DriveFlow
"Online payment didn't go through." on a payment line That attempt failed; try again

A screen or menu item is missing

  • The menu is built from your role and permissions at sign-in. If your school changed your role, sign out and sign in again.
  • Kilometre Log needs the Fleet plan feature and the logging permission.
  • Reports & Analytics, Payments & Invoices, Free Times and the school settings each need their own permission. See Owner and staff features.
  • If you open something and land back on your dashboard, that screen is not on your menu.
  • An instructor who also has a staff role gets the school management screens and no Sign-off screen. See Mobile app overview.

Working without a connection

The app needs a connection for everything except lesson reminders that are already scheduled.

Situation What happens
Open the app offline with a remembered session You stay signed in and see We couldn't check your access with Try again
Open a screen offline "We can't reach DriveFlow. Check your internet connection and try again." Many screens have a Try again button
Lose the connection while sending a sign-off The notes and signature stay on screen; tap the button again when connected
Sign out offline You are signed out on the phone. The server is told nothing, but the phone's push token is dropped

Warning

Nothing is queued to send later. An action that fails has not happened; do it again.

What to tell support

  1. The app version (Settings › About › Version, or under the Sign in card).
  2. Your phone model and Android version.
  3. Your role (student, instructor, staff) and your school.
  4. The exact message, and what you tapped just before it.
  5. The time it happened.

Important

Never send your password to anyone.