Manual
Questions and help
Frequent questions and what to do when something is stuck.
Frequent questions
Do I need internet on the road? No. Only to install, for map updates and – if you switch them on – for Yapaia Go’s optional online services such as traffic reports and fuel prices.
Does Yapaia run on a Raspberry Pi? Yapaia runs on x86-64 and ARM64. For navigation with a country-sized map, though, you need enough memory – plan for 8 GB. An N100 mini-PC is the reference.
Can I use Yapaia Go without Home Assistant? Yes, Go also runs standalone with Docker. Most vehicle features only really shine with Home Assistant, though.
What does it cost? Yapaia itself costs nothing. No subscription, no account, no cloud. Individual add-ons for Yapaia Go from the marketplace may be paid.
Which licence is Yapaia under? The GNU General Public License 3.0 or later (GPL-3.0-or-later): you may use, modify and share Yapaia – modified versions too, as long as they stay under the same licence and come with source code. Go’s add-on SDK and the example add-ons are under Apache-2.0. Yapaia comes without warranty; the person at the wheel is always responsible for the vehicle.
When something is stuck
| You see | This helps |
|---|---|
| “Yapaia” missing in the add-on store | Store → ⋮ → Check for updates, reload the page |
| “Yapaia Go discovered” does not appear | Restart Home Assistant once; the add-on must be running |
| Go shows no map | Manage maps → is a map installed? Open the installation check |
| Route is not calculated | After a map update, wait 30 seconds; otherwise restart the add-on |
| Map server: “token rejected” | Copy the token again, without spaces |
| Beat: no sound | Check the output (mini-PC or this device?), re-plug the stick |
| Vision shows no picture or a rolling one | Check the TV standard – many reversing cameras send NTSC (720x480); check the log to see whether the grabber was detected |
| Router does not switch | Look at the switching sensor; download diagnostics |
Get help
Open an issue on GitHub. Best attach the add-on’s log (add-on → “Log” tab) – it lets us find almost anything.