🚀 pISSstream

it's a simple site that shows how full the International Space Station's urine tank is in real time:

(Yes... that was public information, cause It's publicly funded!)

Uses NASA's official public ISS telemetry stream, provided by Lightstreamer.

---

🐳 Docker / Self-hosting

This is a pure static site, so it ships with a tiny nginx:alpine container — no build step, no dependencies.

Quick start

git clone https://github.com/purple-lines/pISSstream.git
cd pISSstream
docker compose up -d --build

Then open http://<your-server>:8080.

Configuration

Variable	Default	Description
PISSSTREAM_PORT	8080	Host port the site is exposed on.

Copy .env.example to .env and tweak the port if needed:

cp .env.example .env
# edit .env, or just:
PISSSTREAM_PORT=9000 docker compose up -d --build

Common commands

docker compose up -d --build   # build & start
docker compose logs -f         # follow logs
docker compose ps              # status / health
docker compose down            # stop & remove

Update

git pull
docker compose up -d --build

The container only needs outbound internet access: the live urine-tank level is fetched client-side from NASA's Lightstreamer stream, so no backend or API key is required.

---

🥂 Why?

Why not? obsessively watches the urine tank levels on the International Space Station (ISS) !

This project exists because:

• I was bored.
• I love ISSMimic.
• Pee jokes are timeless.
• Space is cool.
• Imagine a situation where all communication has broken down, and the only working sensor is the one in the piss-tank, and the astronauts have to communicate in morse by modulating the delta in the tank. And some guy with ADHD, lurcking on this site, is going to figure out whats going on what is going on, and save them all.
• You could potentially send a notification every time a crew member takes a whizz

---

🚨 Disclaimer

• Not affiliated with NASA, Lightstreamer, or any astronaut's bladder.
• If you’re using this for anything serious, please reconsider your life choices.

🤔 Questions?

Don’t ask. But if you must, open an issue or tweet at us with #PeeInSpace.

🚀 Future Goals

• Port this to gnome extensions.

🧑🏽‍🚀 Acknowledgements

https://iss-mimic.github.io/Mimic/

Be sure to also read the project page:

https://github.com/ISS-Mimic/Mimic

It certainly has more interesting stats than just how full the piss tank is. However, I have no plans to add any of them.