Flash the Raspberry Pi 5
Install Raspberry Pi Imager, write the Asimov image, and configure the robot's name, account, and WiFi.
3.1 Install Raspberry Pi Imager
Download Raspberry Pi Imager from the official Raspberry Pi site:
NOTE: make sure use version <2.0 (as per link below):
additional info (optional):
3.2 Write the image — and make the robot yours
- Insert the microSD card into your laptop.
- Open Raspberry Pi Imager.
- Under Choose OS, scroll to the bottom and pick Use custom, then select
asimov-rpi-<version>.img.xz. - Under Choose Storage, select your microSD card.
- Click Next.
Apply OS customisation
When Imager offers to apply OS customisation, choose “Edit settings” and apply them. This is where your robot gets its name, your account, and your WiFi — it boots straight onto your network, already yours. (If you skip this, nothing is lost: the robot falls back to broadcasting its own setup network.)
Recommended settings, field by field:
| Setting | What to enter |
|---|---|
| Set hostname | Your robot's name — lowercase letters, digits and hyphens (e.g. asimov1). This becomes the dashboard address: http://<name>.local:8080. Give each robot a unique name if you own several. |
| Set username and password | Tick it. Any username except the reserved asimov, asimov-api and asimov-pair; pick a strong password — it is your login and sudo password. The image ships with no default account: skip this and there is no way to log into the OS (the dashboard still works). A reserved username is refused at first boot — the robot then behaves like an uncustomised flash. |
| Configure wireless LAN | Tick it. Enter the WiFi the robot will live on — SSID exactly as broadcast (case-sensitive) and its password. Tick Hidden SSID only if your network is hidden. Set “Wireless LAN country” to the country the robot is in — the dialog often remembers GB from a previous run; a wrong country limits which 5 GHz channels the robot may use. |
| Set locale settings | Tick it and choose your timezone and keyboard layout (log timestamps and console input). |
| Services → Enable SSH | Tick it. “Password authentication” uses the account password from above. Choose “public-key only” instead if you use SSH keys — paste your public key there. |
WiFi compatibility
A 2.4 GHz network is the most reliable choice. The Pi 5's radio cannot see 5 GHz channels 149–165 at all — if your router is pinned there and the robot never joins, move the router to channels 36–48 or enable a 2.4 GHz SSID.
When writing finishes, insert the microSD card into the Raspberry Pi 5
How is this guide?