Bask watches every enclosure. Shed organizes every care task. Haven brings both together so you can walk into the room and know what needs attention.
Free and open-source · self-hosted · no subscription · portable data
Use either project on its own, or install both for the complete animal-room view.
Turn compatible Bluetooth sensors into a calm, room-scale temperature and humidity dashboard.
Give the household one shared place for schedules, completed work, animal records, and trends.
It is the quickest path from “I think everything is okay” to knowing what the room needs right now.
See environmental problems beside unfinished husbandry instead of checking separate screens.
Bask and Shed remain independent apps with separate, portable data. Haven adds no third database.
The dashboard receives only anonymous care totals and outstanding tasks—never identities, access codes, rewards, or write access.
Readable across a room on a wall monitor, while each full app remains available from phones and computers.
Begin with Bask or Shed and add the other later. The installer preserves existing settings and records.
Everything runs on your own Raspberry Pi or other home server. Core use needs no subscription or cloud account.
Run one command on 64-bit Raspberry Pi OS (Lite recommended), Debian, or Ubuntu. The installer prepares Docker, installs your selection, and safely keeps its data between updates.
Choose Haven when prompted to install Bask + Shed and connect the combined dashboard automatically.
curl -fsSL https://animalroom.app/install.sh | bash
When it finishes, the installer prints the address to open — a numeric one such as http://192.168.1.50:8080/room.html. That is the address to use and to bookmark. Memory: 512 MB for Bask, 1 GB for Shed, 2 GB for both.
No. Haven is the combined installation and read-only room display produced by Bask and Shed. The two apps remain independent and retain separate, portable data.
Yes. The same installer offers Bask, Shed, or Haven. Each standalone project also has its own page and installer. You can add the other app later without replacing existing data.
A Raspberry Pi 5 with 4 GB is the recommendation, and 2 GB is the supported minimum. Any 64-bit Raspberry Pi OS, Debian or Ubuntu machine works. Bask additionally needs compatible Bluetooth temperature and humidity sensors. Any browser on your home network can open the apps — phones included.
The operating system matters more than the board. Use Raspberry Pi OS Lite (64-bit): a desktop session idles near 800 MB where Lite uses about 280 MB. A 1 GB board running a desktop has roughly 200 MB free — not enough for Shed to start — while the same board on Lite has room to spare. You never need a screen attached; everything is opened from a phone or laptop.
Nothing is compiled during installation. Both apps ship as prebuilt multi-architecture images, so your board only has to run them. Measured moments after a fresh start: Bask 106 MB plus 55 MB for its Bluetooth scanner, Shed 154 MB, and the Haven room proxy 46 MB — about 360 MB for all of it. Shed answers its health check 4 seconds after starting.
A 512 MB Pi Zero 2 W is a Bask-only board — enough for Bask on Lite, not enough for Shed. The installer checks free memory before changing anything and tells you if there is not enough, instead of failing part way through. You can also start with one app and add the other later; the installer will not disturb what is already there.
No. The room display uses a private server-to-server connection and receives a deliberately limited Shed feed. It excludes household identities, access codes, rewards, history, completion identifiers, and all write access.
Internet access is needed for installation and updates. Normal local monitoring, care records, and the Haven dashboard run on your home network. Optional notification services use the provider you choose.
Run curl -fsSL https://animalroom.app/uninstall.sh | bash and choose what to remove. Your records are kept by default — the apps stop and their containers and images go, but the data directories stay where they are, so reinstalling later (here or on a different machine) picks up where you left off. You can remove one app and leave the other running. Add --purge to erase the records too; it writes a backup archive first and asks you to confirm.
Two things cause almost all of these. First, the address: use the numeric one the installer printed, like http://192.168.1.50:3000. If it worked before and stopped, your router most likely gave the machine a new address — check it, and reserve it there to stop it moving again. Second, memory — if the board ran out while starting, the app is killed and the address simply refuses to load.
This reports both, plus anything else useful, and you can paste the result to whoever is helping:
curl -fsSL https://animalroom.app/doctor.sh | bash
It only reads your system and changes nothing. It contains no records, passwords, or access codes — settings are listed by name only, never by value.
No. Haven helps you monitor, plan, and record care. Species targets and schedules should come from appropriate, trusted sources, and health concerns belong with a qualified veterinarian.