junkerderprovinz/stellarium repository overview

Stellarium, in your browser. Explore the night sky from any device. No VNC client, no local install.
This runs the full Stellarium desktop planetarium inside a single container and streams it to your browser over Selkies⁠ (H.264 video), so panning the sky, zooming into a nebula and scrubbing through time stay smooth, the part of a real-time planetarium where the old noVNC containers feel laggy.

A one-knight job: I build it, keep it running, work through the issues and add what people ask for, until nothing is missing. It is free, with no accounts, no telemetry, no ads and no paid tier. No asterisk anywhere. Nothing readable ever leaves your own walls. Forged on evenings and weekends, with heart and stubbornness.

If it has earned a place on your server or computer, toss a coin to your knight: it helps cover the costs and keeps the project alive. It also makes this knight's heart beat a little faster. Three ways below, whichever suits you.

⁠Table of Contents

1. What is this?⁠
2. Why Selkies?⁠
3. Install on Unraid⁠
4. Configuration⁠
5. First use⁠
6. How it works⁠
7. Credits⁠
8. License⁠
9. How AI is used here⁠
10. Support this project⁠

⁠1. What is this?

An own-image container that packages Stellarium⁠ (the free, open-source desktop planetarium) on top of LinuxServer.io's baseimage-selkies⁠ and serves its desktop UI straight to your browser. No X client, no VNC viewer, no separate install on your workstation: open the WebUI and look up.

There is no maintained browser-desktop build of the actual Stellarium application. The only "in a browser" option is Stellarium Web, a separate and much lighter JavaScript reimplementation, not the full desktop program with its plugins, catalogues and sky cultures. This is a maintained, modern Selkies 2.0 build of the real thing for amd64 and arm64.

Stellarium itself is installed from Debian trixie's stellarium package, so it tracks Debian's security updates and works natively on both architectures.

⁠2. Why Selkies?

A planetarium is a continuous-rendering workload: you drag across the sky, zoom into a star cluster, speed up time to watch the planets move, and swing the whole celestial sphere around. Over the older noVNC stack that constantly changing canvas feels laggy because the whole frame is re-encoded on every change. Selkies streams the desktop as H.264 video, the same reason LinuxServer moved Blender and FreeCAD onto it, so the sky stays fluid. When the host has a GPU the base wires it through; without one it falls back to software rendering (Mesa llvmpipe) so it still works.

⁠3. Install on Unraid

Requires Unraid 6.12+. Install via Community Applications: search for Stellarium (look for the junkerderprovinz maintainer). Or add the template repository manually under Docker → Add Container → Template repositories:

https://github.com/junkerderprovinz/unraid-apps

Then open the WebUI on the mapped HTTPS port (default 3001).

⁠4. Configuration

Stellarium's configuration, chosen location, downloaded star catalogues, landscapes, plugins and screenshots all persist under /config (in /config/.stellarium), so nothing is lost across image updates.

⁠Screen size and memory use

The desktop follows your browser window: Selkies resizes the screen to the size the browser reports, so there is no screen size to set and memory only grows with the window you actually use. A 1600x1000 window on a laptop set to 200 % counts as 1600x1000. With HiDPI switched on in the Selkies sidebar the same window counts in physical pixels, 3200x2000.

Display scaling follows the browser without any setting. Every browser is streamed at the size it reports, with the desktop at 96 DPI, so Stellarium looks the same on a 100 % desktop and on a laptop set to 200 %. On the laptop the picture is a little softer, because the browser stretches it. The HiDPI switch in the Selkies sidebar is remembered per browser and wins over this default. With it on, a high-resolution display gets its physical pixels and Stellarium is drawn at half size, so if Stellarium looks tiny on a laptop, switch HiDPI off there.

⁠5. First use

1. Open the WebUI. Stellarium starts maximised, showing the sky for its default location.
2. Set your location (press F6, or the location button in the left toolbar) so the sky matches where you are; it is remembered for next time.
3. Explore: drag to pan, scroll to zoom, use the bottom toolbar to toggle constellations, atmosphere, grids and labels, and the time controls (J / K / L) to slow, pause or speed up time.
4. Want more? Stellarium's Configuration window (F2) enables plugins: the telescope control, satellites, exoplanets, meteor showers and more.

Closing the Stellarium window simply reopens a fresh instance. It is the container's single app (kiosk model), so there is nothing else to manage.

⁠6. How it works

Browser ──WebSockets (Selkies)──> Stellarium container
                              ├─ nginx (Selkies WebUI, HTTPS :3001)
                              ├─ openbox + Selkies desktop
                              └─ /usr/bin/stellarium  (Debian trixie package)
                                 └─ /config/.stellarium  (location, catalogues, plugins, persisted)

Built on ghcr.io/linuxserver/baseimage-selkies:debiantrixie. A small s6 overlay seeds the openbox autostart (which launches Stellarium as the session's single app), keeps the WebUI login-free unless you set credentials, and prints a STELLARIUM IS READY banner to the container log once the WebUI is serving. Images are built natively per architecture, boot-smoke tested (the binary is present and the WebUI answers) before publishing, and scanned for CVEs.

⁠7. Credits

• Stellarium⁠ by the Stellarium developers (GPL-2.0), the planetarium this image packages. Installed from the Debian stellarium package. This project is not affiliated with or endorsed by the Stellarium project.
• LinuxServer.io baseimage-selkies⁠ (GPL-3.0), the Selkies web-desktop base.
• Selkies⁠, the desktop streaming stack.

See NOTICE⁠ for the full bundled-software license list. This repository's own wrapper (Dockerfile, rootfs, scripts, artwork) is AGPL-3.0; see LICENSE⁠.

⁠8. License

Copyright (C) 2026 Junker der Provinz.

This repository packages Stellarium as a container for Unraid. The packaging in this repository (Dockerfile, scripts, theme, web assets and everything else original here) is free software under the GNU Affero General Public License v3.0 (AGPL-3.0); see LICENSE⁠. If you distribute it, or run a modified version as a network service, you must release your source under the same AGPL-3.0 terms and keep the existing copyright and attribution notices intact.

Scope. The AGPL applies to this repository's own code and assets. Stellarium itself is a separate project under its own license and name; this repository does not claim it. The banner, logo, theme and other branding original to this repository remain reserved: a fork must use its own branding and may not present itself as this project.

⁠9. How AI is used here

One knight builds this, and AI is one of the tools I work with, the same way I work with an editor or a compiler. It helps me write code and documentation and it checks my work, and that saves me a good many evenings. It does not make the decisions, though. I read and understand everything before it ships, and if something here breaks, that is on me and not on the tool.

You do not have to take my word for it. The code is open and every release note is written by hand. The issue tracker shows how problems actually get handled, including the ones I got wrong the first time. If you find something that is not right, open an issue and I will look at it.

⁠10. Support this project

Questions, bugs, ideas or feature requests? Please open a GitHub issue⁠.

A one-knight job: I build it, keep it running, work through the issues and add what people ask for, until nothing is missing. It is free, with no accounts, no telemetry, no ads and no paid tier. No asterisk anywhere. Nothing readable ever leaves your own walls. Forged on evenings and weekends, with heart and stubbornness.

If it has earned a place on your server or computer, toss a coin to your knight: it helps cover the costs and keeps the project alive. It also makes this knight's heart beat a little faster. Three ways below, whichever suits you.