Bask watches the habitat. Shed organizes the care. Haven brings both into
one calm room dashboard.
Haven is not another database or another app to maintain. It is the combined
installation and read-only wall display you get when Bask and Shed run
together. Each app stays independent, and each keeps its own portable data.
Meet Haven on the project website →
Not ready to install? Try the interactive fake-data demo,
read how the projects are built and tested,
or see the real room behind them on
Instagram.
Which should I choose?
| Choice | Best when you want |
|---|
| Bask | Live enclosure temperature and humidity monitoring from compatible Bluetooth sensors |
| Shed | Shared care schedules, household task attribution, weights, feeding, equipment, notes, and history |
| Haven (recommended) | Everything in Bask and Shed, plus one wall dashboard showing enclosure status and today's remaining care |
You can start with either app and run the installer again later to add the
other one and enable Haven. No data is replaced.
What you need
For the combined Haven setup, a Raspberry Pi 5 with 4 GB is the
recommendation. Haven's supported minimum is 2 GB; either app can run alone
on a smaller board. The board matters less than what else it is running — see
below.
| Bask alone | Shed alone | Haven (both) |
|---|
| Free memory needed | 240 MB | 400 MB | 650 MB |
| Minimum board | 512 MB | 1 GB | 2 GB |
| Recommended | 1 GB | 2 GB | 4 GB |
Any 64-bit Debian, Raspberry Pi OS or Ubuntu system works, plus a few GB of
free disk. Bask also needs a Bluetooth adapter and compatible sensors.
The OS matters more than the board
Use Raspberry Pi OS Lite (64-bit). A desktop session is the single biggest
consumer of memory on a small board — Lite idles near 280 MB where a desktop
can take 800 MB or more. A 1 GB board running a desktop has roughly 200 MB
free, which is not enough for Shed to start, while the same board on Lite has
ample room. You do not need a screen on the machine: every app is opened from a
phone or laptop on your network.
On a PC rather than a Pi, plain Debian or Ubuntu LTS both work.
What the apps actually use
Nothing is compiled during installation. Both apps are published as prebuilt
multi-architecture images, so installing downloads a container and starts it —
your board only ever has to run the apps, not build them.
Measured on an arm64 Pi, moments after a fresh start:
| resident memory |
|---|
| Bask (web) | 106 MB |
| Bask (Bluetooth scanner) | 55 MB |
| Shed | 154 MB, answering its health check 4 seconds after start |
| Haven room proxy | 46 MB |
| All of it together | ~360 MB |
Shed will grow beyond that over time on a large machine — it is a JavaScript
runtime, and its heap expands to use memory that is going spare. That is not a
requirement, and it sizes itself down on a smaller board.
A Pi Zero 2 W is a Bask board. 512 MB total leaves enough for Bask on Lite
and not enough for Shed. The installer checks free memory before it changes
anything and tells you if there is not enough, rather than failing halfway.
You can also start with one app and add the other later; the installer will not
disturb what is already there.
Install
On 64-bit Raspberry Pi OS (Lite recommended), Debian, or Ubuntu, run:
curl -fsSL https://animalroom.app/install.sh | bash
Choose Bask, Shed, or Haven. The installer adds Docker from Docker's
official repository for your distribution when needed, installs the selected app or apps, and
automatically makes the secure server-to-server connection required by Haven.
For an unattended Haven install:
curl -fsSL https://animalroom.app/install.sh | bash -s -- --haven
--bask, --shed, and --all are also accepted. --all is an alias for
Haven. Re-running the command updates the selected apps without replacing data.
Addresses and storage
The installer finishes by printing the address for each app it set up. Use the
numeric one — http://192.168.1.50:3000, with your board's own address.
It works from every phone and computer on the network.
| Surface | Address | Persistent data |
|---|
| Bask | http://LAN-ADDRESS:8080 | ~/bask/data |
| Shed | http://LAN-ADDRESS:3000 | ~/shed/data |
| Haven room display | http://LAN-ADDRESS:8080/room.html | Reads Bask and Shed; stores no separate copy |
That address comes from your router's DHCP lease, so reserve it for the machine
in the router's settings if you want the bookmark to keep working.
The installer used to offer http://HOSTNAME.local:PORT alongside it. It no
longer does: that name needs mDNS, which Windows without Bonjour and a good many
Android phones do not do, and there the address simply refuses to load with
nothing on screen to say why. It is still printed when no LAN address can be
determined — during early boot, for instance — because then it is the only
answer available.
Set ANIMAL_ROOM_HOME or pass --install-root PATH to choose a different
parent directory.
What Haven shares
Haven gives Bask read-only access to a deliberately limited Shed display feed.
That feed includes today's incomplete and overdue care plus anonymous totals.
It excludes household identities, rewards, access codes, history, completion
IDs, and all write access. A separate random display secret is generated during
installation and stays in the apps' private .env files; it is never sent to
the browser.
Because Bask and Shed remain separate services, either app can still be used on
its own. The room display clearly reports when one side is unavailable instead
of hiding the failure.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
