---
id: troubleshooting
type: troubleshooting
title: Troubleshooting
summary: "Fixes for the common problems: the OBU won't connect, charges or the card balance don't show, the drive card doesn't appear, a drive wasn't recorded, the Kerbside server can't be reached, there's no band or leave time, Explore is empty, alerts or watches don't arrive, and the Cabin camera doesn't start."
section: kb
url: "https://irrhuh.app/kerbside/kb/troubleshooting.html"
related: [connect-your-obu, obu-page, kerbside-server, faq, support]
platform: [iphone, carplay]
applies_to: 1.0
updated: 2026-11-18
---

# Troubleshooting

Each problem below starts with the most likely fix. If nothing helps, [write in](https://irrhuh.app/kerbside/support.html) with a screenshot of Settings › OBU (ERP 2.0) › **Event log**.

## The OBU won't connect

1. **The car is on** and the OBU has power.
2. **Another app has the OBU.** The OBU talks to one app at a time. Close LTA's ERP 2.0 app, Breeze or any other OBU app. If iOS **Settings › Bluetooth** shows the OBU as Connected while Kerbside isn't, tap ⓘ next to it › **Forget This Device**, then connect again from Kerbside.
3. **Setup isn't finished.** In Settings › OBU (ERP 2.0) › **Setup**, both **Initialise SDK** and **Grant OBU data permission** need a tick.
4. **Bluetooth is off** (error 1001), or Kerbside isn't allowed to use it: iOS Settings › Kerbside › Bluetooth.
5. **No internet** (error 1000). LTA's software needs it to connect.
6. **"Bluetooth MAC address not registered"** (error 2006). Your iPhone's Bluetooth address must be registered with LTA for this OBU (e-Services, up to 5 phones per OBU). It's in iOS **Settings › General › About › Bluetooth**.
7. **Searching finds nothing.** Search again with the car on and the iPhone inside the car. A search lasts up to 60 seconds.
8. **"No answer from the OBU yet"** after 45 seconds. Tap **Stop and try again**.

The error codes are on the OBU page's orange line. "Developer key blocked" (1003), "app blocked" (1004) or "invalid SDK key" (401) are problems on Kerbside's side: please write in.

## It connected before but doesn't reconnect

- Open Kerbside with the car on. It reconnects when the app opens or comes back to the front.
- Save your car plate on the OBU (Settings › OBU (ERP 2.0) › My OBUs › your OBU). With a plate, Kerbside reconnects without searching.
- For reconnecting while Kerbside is closed, set Location to **Always**.

## A charge is missing, or the trip total looks wrong

- Charges deducted while Kerbside wasn't connected are filled in from the OBU's payment record the next time it connects. The OBU only keeps its last 5 payments of the trip.
- About 50 seconds after a trip summary, Kerbside compares the OBU's trip totals with what it recorded. If something's missing, it sends "A charge may be missing". Add the difference in the Ledger with **+**.
- Kerbside only reports what the OBU tells it. For questions about a charge itself, contact LTA.

## The card balance shows "—" or "Account"

- **"—":** the OBU hasn't reported a balance yet in this trip. It appears after the OBU's first card update.
- **"Account / backend payment":** the OBU pays from a backend account, not a card.
- **"Card problem":** the OBU reports the card is missing, expired, blocked, faulty or out of value. Check the card in the OBU.

## The drive card doesn't appear

- It starts by itself only when the OBU connects **while Kerbside is on screen**. iOS doesn't let apps start it from the background. Open Kerbside, or tap **Drive card** on the Drive tab.
- Check Settings › Alerts and drive card › **Drive card (Live Activity)** is on.
- Check iOS Settings › Kerbside › **Live Activities** is on.
- On CarPlay, the drive card shows on the **Dashboard** with iOS 26 or later.

## The drive card stays after I've parked

It ends when the OBU sends its trip summary. If the OBU stopped without one, tap **End card** on the Drive tab, or use the "End Kerbside drive card" shortcut.

## A drive wasn't recorded

- Settings › **Record drives** must be on.
- Location must be allowed: While Using, or **Always** if the OBU connected while Kerbside was closed. Without location, a drive records nothing, even with **Record a drive now**.
- Drives with fewer than 5 points and no charges aren't kept.

## The Border tab says "Can't reach your Kerbside server"

The Border tab, Explore, Advanced mode, road-ahead alerts and watches all need the [Kerbside server](https://irrhuh.app/kerbside/guide/kerbside-server.html). Open Settings › **Kerbside server** and read the line under the address.

- **"The server address in Settings isn't a valid URL":** check the address you typed, then tap **Use this address**. Empty the box to use the default address.
- **A timeout or "could not connect":** the server isn't running or the iPhone can't reach it. If the server is on your Wi-Fi, check the iPhone is on the same network and that iOS Settings › Kerbside › **Local Network** is on.
- **"Server error" with a number:** the server answered with an error. Try again later.
- **"…the answer didn't come from the Kerbside server":** another program is answering at that address. The server's operator needs to fix it.

Once it works, the line says **Connected · updated HH:mm** and the Border tab fills in within a few seconds. Pull down on the Border tab to try again.

## The band is missing, but the rest of the Border tab works

The server shows a band only from camera pictures less than 30 minutes old. If LTA's cameras haven't updated, or the server hasn't counted them, there's no "Singapore side now" row (the CarPlay app says "No recent camera frames"). Try later.

## There's no leave-time suggestion

The Border tab says why under "About N min of driving now":
- **"…after Kerbside has logged at least one full day":** the server has no history yet.
- **"Your usual window (…) is over for today":** with **I cross at regular times** on, your window has passed. Turn it off in Settings › Leave time, or wait for tomorrow.
- **"Suggestions cover today until 23:30":** the time you picked is after 23:30 or tomorrow.
- **"Not enough logged history for the rest of tonight's window yet":** the server hasn't logged those half-hours often enough.

## Explore shows no carparks or markers

- Zoom in. Layers load only when you're zoomed in to part of the island, and **Carparks** and **EV** only within a few kilometres. The line under the map says which.
- Check the layer's chip is on (coloured).
- An orange line under the map is an error from the Kerbside server; see "Can't reach your Kerbside server" above.

## There's no Drive tab, heads-up or Explore

You're in Advanced mode, which has Board, Forecast, Ledger and Settings. Switch back in Settings › **Mode** › **Calm**. See [Calm and Advanced modes](https://irrhuh.app/kerbside/guide/modes.html).

## Busy streets says "old" or doesn't show on the heads-up

LTA's latest speed reading on the server is over 2.5 hours old, so the heads-up hides the card and the Border tab marks it "old". Also check Settings › Busy streets › **On the heads-up Drive page** is on. On a full Drive page the card steps aside for the OBU's cards.

## Notifications don't arrive

- Check iOS Settings › Notifications › Kerbside is allowed.
- Check the alert's own setting in Settings › Alerts and drive card.
- During a Focus (Driving, Do Not Disturb), add Kerbside to the Focus's allowed apps.
- The border alert before a checkpoint needs Location set to **Always** and the Kerbside server, and is skipped on your way back from Johor when the crossing timer saw you leave the Johor side.
- Road-ahead alerts need the Kerbside server and Kerbside following your position: the OBU connected, heads-up mode open, or Explore on screen. At most one every 3 minutes and 6 per drive.

## "Tell me when it's ~30 min or less" never arrived

- Check Settings › Alerts and drive card › **This iPhone** says **Registered** with no orange line. **Not registered** means your build of Kerbside can't use Apple Push, or iOS refused; watches can't arrive.
- The Kerbside server sends watches only once Apple Push is set up on it; until then they're saved but not sent.
- A watch lasts 6 hours and sends at most one notification. If the band didn't drop to ~30 min in that time, nothing is sent.

## Kerbside isn't on the CarPlay screen

Kerbside's own CarPlay app appears only in builds with Apple's CarPlay permission for driving-task apps. The drive card on the CarPlay Dashboard (iOS 26) works without it. See [Kerbside in CarPlay](https://irrhuh.app/kerbside/guide/carplay.html).

## The heads-up speed shows "–"

Heads-up speed comes from the OBU, or from your iPhone's GPS (marked **KM/H · GPS**) when the OBU isn't sending one. "–" means neither has a reading: check that Location is allowed for Kerbside and that the iPhone can see the sky.

## The Cabin page doesn't show my face

- **"Camera access is off":** turn on iOS Settings › Kerbside › **Camera**. (The message may say "My Kerbside"; in iOS Settings the app is listed as Kerbside.)
- **"This iPhone can't track faces":** face tracking needs an iPhone that supports it. The rest of heads-up mode still works.
- **"Can't see your face" or "… it's dark":** the front camera needs to see your face and some light. The screen's own light helps; a very dim heads-up gives it less.
- **"Paused: the iPhone is hot":** the camera stops while the iPhone is hot and starts again when it cools.
- **"Off in mirror mode":** turn mirror off in the control bar.

## The heads-up level or tilt says "learning…"

Kerbside learns how the phone sits in your mount while you drive straight and steadily, typically in about 3 minutes. If you moved the phone, it relearns. You can force it with **Relearn level** on the Sensors page.

## The demo drive won't stop

Close Kerbside from the app switcher and open it again. Tap **End card** first to remove the drive card.
