---
id: kerbside-server
type: concept
title: The Kerbside server
summary: The Kerbside server collects Singapore's traffic, checkpoint and carpark open data around the clock and answers Kerbside's questions about it. The Border tab, Explore, Advanced mode, road-ahead alerts and border watches need it; the OBU features, Ledger, recorded drives and heads-up mode don't. Set it in Settings › Kerbside server.
section: start
url: "https://irrhuh.app/kerbside/guide/kerbside-server.html"
related: [border, explore, alerts, privacy, troubleshooting]
platform: [iphone, carplay]
applies_to: 1.0
updated: 2026-11-18
---

# The Kerbside server

The Kerbside server is a separate program that Kerbside, the iPhone app, talks to over the internet. It logs Singapore's open data (LTA's checkpoint cameras, travel times, carpark lots, traffic messages and NEA's weather) every few minutes, counts the vehicles in the checkpoint pictures, and keeps the history that leave-time suggestions and "usually" figures are worked out from.

Kerbside's OBU features don't use it. Charges, the card balance, LTA's messages, the drive card, the Ledger, recorded drives and heads-up mode work without it.

## Set the address

1. Open Settings › **Kerbside server**.
2. Type the server's address in the box and tap **Use this address**. Leave the box empty to use the default address built into the app.
3. Check the line under the box: **Connected · updated HH:mm** in green means Kerbside reached the server. An orange line gives the error instead. See [Troubleshooting](https://irrhuh.app/kerbside/kb/troubleshooting.html#the-border-tab-says-cant-reach-your-kerbside-server).

If the server is on the same Wi-Fi network as the iPhone, iOS asks once whether Kerbside may find devices on your local network. Allow it, or Kerbside can't reach the server.

## What needs the server

| Feature | With the Kerbside server | Without it |
|---|---|---|
| [Border tab](https://irrhuh.app/kerbside/guide/border.html) | The Singapore-side queue band, the leave-time suggestion, the evening chart, rain and incident chips, busy streets, and lots at your saved carparks | An orange "Can't reach your Kerbside server" box and "No crossing data yet" |
| [Advanced mode](https://irrhuh.app/kerbside/guide/modes.html) (Board and Forecast) | Live minutes, charts, the heatmap and signals | "NO DATA" and the error |
| [Explore](https://irrhuh.app/kerbside/guide/explore.html) and **Plan parking** | Map layers and carparks near a destination | The map with your own position only, and the error under it |
| Border band on the heads-up Drive page and the drive card, near a checkpoint | Shown | Not shown |
| Border band notification about 3 km before a checkpoint | Sent | Not sent |
| [Road-ahead alerts](https://irrhuh.app/kerbside/guide/alerts.html#road-ahead-alerts) (signs, faulty lights, flood alerts, your carpark's lots) | Sent | None |
| Busy streets card on the heads-up Drive page | Shown | Hidden |
| **Tell me when it's ~30 min or less** | The server sends one notification through Apple Push | "Couldn't set it" with the error |
| [Crossing timer](https://irrhuh.app/kerbside/guide/crossing-timer.html) | Uses the server's checkpoint areas; **Share timings** sends your timings | Works with the areas built into the app; shared timings wait and are sent later |
| [CarPlay app](https://irrhuh.app/kerbside/guide/carplay.html) **Border** screen | The bands for both checkpoints | "Kerbside server not reachable" |

Heads-up mode's weather (Sky page) and HDB carpark lots (Parking page) don't need the server: Kerbside downloads them from data.gov.sg directly.

## How often Kerbside asks

| What | How often | Source |
|---|---|---|
| Border tab and Advanced mode figures | Every 2 minutes while Kerbside is open, when it comes back to the front, when you change the route, and when you pull down on the Border tab | Kerbside's code |
| Border band during a drive (heads-up, drive card) | At most every 5 minutes, while the OBU is sending its speed | Kerbside's code |
| Road-ahead list | At most every 5 minutes, while Kerbside is following your position | Kerbside's code |
| Busy streets | At most every 10 minutes; the server logs LTA's speeds once an hour | Kerbside's code |
| Explore | When you change a layer or the time, and when the map stops moving if it moved more than a quarter of the screen, zoomed noticeably or last loaded over a minute ago | Kerbside's code |

LTA's checkpoint cameras change about every 5 minutes, so a newer band can't appear faster than that.

## What Kerbside sends to the server

| When | What's sent |
|---|---|
| Every refresh of the Border tab and Advanced mode | The checkpoint and direction you picked, the date and your leave-time window |
| Explore | The rectangle of map on screen, the layers that are on, Car or Motorcycle, and the "Usually at…" time if you set one. While the map follows you, that rectangle is around where you are |
| Plan parking | The position of the destination you searched for or saved, the walking distance, the arrival time, and Car or Motorcycle |
| Your places on the Border tab | The ids of your saved carparks |
| You get within 1 km of your trip carpark or a saved carpark | That carpark's id; if it has 5 lots or fewer, also its position, to find one nearby with space |
| Each time Kerbside opens | A random id made by Kerbside on this iPhone, the Apple Push token iOS gives Kerbside, and whether it's a development or release build |
| You set a watch | The random id, checkpoint, direction, the band to wait for (~30 min) and how long to watch (6 hours) |
| A crossing is timed, with **Share timings** on | The random id, checkpoint, direction, and start and end times. No positions |

Like any internet request, each one also carries your iPhone's IP address.

Kerbside never sends the server your GPS position, your recorded drives, charges, card balance, Ledger, OBU number, car plate, photos, or the motion and eye numbers from heads-up mode. The [privacy policy](https://irrhuh.app/kerbside/privacy.html) has the full list.

## What it isn't

- **It isn't an account.** There's no sign-in, no sync and no backup of your data. Nothing you record moves to the server.
- **It doesn't talk to your OBU.** Only the iPhone does, over Bluetooth.
- **It doesn't see immigration or the Malaysian side.** The band covers the Singapore side of the checkpoint only.
- **It doesn't guess.** A leave-time suggestion appears only once the server has logged at least one full day; until then the Border tab says so.
