Free trial
Colour

Getting started and what to do if you get stuck

Install Pop Dispatch, finish the first-run wizard, add your people and phones, take your first tow, repair and taxi job, make backups, fix the common problems and reach support.

For
OwnerAdministrator
Hosting
Any hosting
Devices
All devices
Business
All businesses

Checked against Pop Dispatch 0.1.0

This guide takes you from a new install to your first jobs and your first backup, then lists the common fixes and how to reach support. Each section links to the article that has every step, so you can follow one thread from start to finish.

Before you start #

  • Your licence key or trial key. It starts with PSDP and arrives by email.
  • The owner's email address and an authenticator app on a phone.
  • For the office server: one computer that stays on during business hours. See "Hardware compatibility guide".

1. Install #

Choose where your server runs.

  1. Mac. Open the disk image, drag the app to Applications, open it and choose how this Mac is used. See "Installing Pop Dispatch on a Mac".
  2. Windows. Run the installer and choose how this computer is used. See "Installing on Windows".
  3. Cloud. Pop Street runs the server for you at https://<your account name>.dispatch.thepopstreet.com. Open that address in a browser, or enter it in the Mac or Windows app. See "The hosted plan".

On a Mac or Windows PC the first screen asks whether this computer holds your business data (the office server), joins an office server that already runs, or signs in to the hosted service. Choose the first on exactly one computer.

2. The first-run wizard #

The wizard opens in your browser and moves through these steps. Each page has its own article.

  1. Language and start: "Welcome and choosing how to start".
  2. Licence key or trial: "Adding your licence key".
  3. Owner account and recovery key: "Owner account, recovery key and authenticator app". Write the recovery key down and keep it away from the server computer. It appears once.
  4. Business details: "Your business details".
  5. Modules: "Choosing your modules". Pick towing and roadside, repair and collision, or taxi and livery.
  6. Import: "Importing your data during setup". You can skip it and return later.
  7. Trucks, drivers and customers: "Importing trucks, drivers and customers".
  8. Connect devices: "Connecting phones and computers".
  9. Backups: "Backups".
  10. Done: "Finishing setup".

Anything you skip waits in "The Get running checklist".

3. Add your staff #

  1. Open Settings and add each person with one of six roles: owner, manager, advisor, dispatcher, technician or driver. See "Roles and what each can do".
  2. Every owner and manager signs in with a second step. See "Two-step sign-in for owners and managers".
  3. Each person signs in with their email and a one-time password, then picks their own password. See "Signing in, tokens and lockout".

4. Connect driver phones #

  1. In the wizard step Connect devices, or later, choose Make a phone code.
  2. Open the driver app in the phone's browser and scan the QR code. Each code works once and lapses after 24 hours. See "Connecting phones and computers".
  3. Make a new code for every phone. See "The driver app, shifts, photos and signatures".

5. Your first jobs #

Do one of each so the screens become familiar.

6. Backups #

Pop Dispatch makes a backup each night and checks that it restores. Take one now as well: open Settings, then Backup, and choose to back up now. Copy backup files to a second disk or folder, and keep the recovery key somewhere else. See "Backups and restore" and "Backup files, schedule and the monthly test".

Something is wrong #

Start here. Each line names the article with the steps.

What you seeTry thisArticle
Nobody can open the consoleCheck that the server computer is on and open the health page"Server health", "Server down or restoring a backup"
A phone cannot connectCheck the address phones use in the Connect devices step, and make a fresh code"Connecting phones and computers"
The screen says read-onlyConnect the server to the internet and check the licence"What happens when your licence ends or the check fails", "Licence expired or unreachable"
Read-only after a clock change or a long time offlineCorrect the clock and check the licence"Clock and offline troubleshooting"
The key is refusedCheck the key shape; the working licence stays in place"Activating a new licence key"
Locked out after wrong passwordsWait, or ask the owner to reset the password"Signing in, tokens and lockout"
Lost authenticator phoneContact support"Two-step sign-in for owners and managers"
Lost phone or computerCut off its access"Lost or stolen device"
Lost the recovery keySteps depend on whether the server still runs"Lost recovery key"
The server restarted in safe modeRead what it shows, then use the Restored your last session bar"Safe mode, crashes and the Restored your last session bar"
The Mac shows OfflineChanges wait in the queue and send when the connection returns"Working offline on the Mac"
A driver's save did not sendOpen the Outbox from the status pill"Working offline and the Outbox"
An import found problemsRead each message with its row number"Fixing import problems"
Wrong data after a mistakeRestore an earlier day, keeping today's data safe"Restoring yesterday's data"
The computer diedRestore on a new computer with your backup and recovery key"My computer died"

Contact support #

  1. Open https://thepopstreet.com/support and fill in the support ticket form. Pop Street replies to the email address you give.
  2. Say which computer or phone you used, what you were doing, what the screen said (a photo of the screen helps) and the time it happened.
  3. Add the version number from the Mac or Windows app, and the server health page's answer when the server is involved.

Never send your password, a one-time password or your recovery key. Support never asks for them.

Technical details
  • The server health page answers at /health and reports ok, the version and the licence state.
  • The first-run wizard runs at http://127.0.0.1:8480/setup on the server computer until the owner account exists.
  • Backups sit in the server's data folder; the schedule and the folder are in Settings, Backup.

If something goes wrong #

  • A step above names a screen you cannot find: your role may lack access. See "Roles and what each can do".
  • A step fails with an error code: search the code in the help, or send it with your support message.