Bask watches enclosure climate. Shed organizes care. Haven brings both into one clear room dashboard. Everything runs on hardware you control.
Free and open source · self-hosted · no subscription · portable data
Animal Room began with two everyday needs: see every enclosure at a glance and give the whole household one reliable care list. Bask, Shed, and Haven now run here every day.
Follow the real animal room on Instagram →
Use either tool on its own. Install both to add the Haven room display.
Good care shows.
Shared care schedules and records for the whole household. See what is due, what is done, and who handled it.
See the room at a glance.
Turns compatible Bluetooth sensors into a clear climate dashboard for every enclosure.
The whole room, one view.
The paired Bask + Shed setup, with a read-only dashboard for the whole room. No third database or extra records to manage.
Use a Raspberry Pi or another home server. Core features need no Animal Room account or cloud service.
Download JSON and CSV exports, and keep dated local backups.
Fix a mistaken entry without erasing the record. Corrections stay visible and auditable.
MIT licensed. Tips are optional and never unlock features.
One command installs Bask, Shed, or both as Haven on 64-bit Raspberry Pi OS, Debian, or Ubuntu.
Pick one now and add the other later. Updates preserve your settings and records.
curl -fsSL https://animalroom.app/install.sh | bash
Prefer to read it first? View the script — it's plain bash, and worth skimming before you pipe anything to a shell.
It finishes by printing the address to open — a numeric one like http://192.168.1.50:3000. Bookmark it. That address comes from your router, so reserve it for the machine in your router's settings if you want it to stay the same.
For Haven, use a Raspberry Pi with at least 2 GB; a Pi 5 with 4 GB is the easy recommendation. Bask can run by itself on a 512 MB Pi Zero 2 W. Shed needs at least 1 GB. Any 64-bit Raspberry Pi OS, Debian, or Ubuntu machine works.
Raspberry Pi OS Lite (64-bit) leaves more memory for the apps than the desktop edition. No screen needs to stay attached: open everything from a phone or computer on your home network. Bask also needs compatible Bluetooth temperature and humidity sensors.
The installer checks available memory before making changes, and both apps use prebuilt container images rather than compiling on your machine.
No. Every app stands on its own, and the installer lets you choose. You can add another later without disturbing the data you already have.
Only installation, updates, and optional integrations do. Monitoring, care records, and the Haven display run on your home network.
Core use has no product analytics, telemetry, or Animal Room account. Records stay on your machine and can be exported or backed up at any time.
Optional alerts and smart-device integrations contact the provider you choose. The Trust page explains each boundary.
Use the numeric address printed by the installer, such as http://192.168.1.50:3000. If it stopped working later, your router may have assigned the machine a new address. Low memory can also stop an app from starting.
Run curl -fsSL https://animalroom.app/doctor.sh | bash for a read-only diagnostic report. It excludes records, passwords, access codes, and secret values.
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 picks up where you left off. Add --purge to erase the records too; it writes a backup archive first and asks you to confirm.
No. These tools help you monitor, plan, and record care. Species targets and schedules should come from trusted husbandry sources, and health concerns belong with a qualified exotics veterinarian.
One keeper building for a real, bioactive-heavy animal room. The code is open on GitHub, and practical feedback is welcome.