SkyLabA self-hosted cloud for schools

Students request machines, teachers build whole classrooms, administrators keep Proxmox VE under control.

🖥️

Virtual machines and containers

VM and LXC lifecycle on Proxmox VE with VNC and terminal consoles in the browser, snapshots, backups, resizing and scheduled start and stop.

🎓

Teaching at scale

Platform templates, classes, rosters and timetables. Provision a whole class in one batch or publish multi-machine teaching environments.

✅

Request workflow

Students submit a request, reviewers approve it, SkyLab checks capacity for the time window and provisions the machine on schedule.

🌐

Network control

Firewall topology, NAT and domain rules, IP management, and a gateway VM reached through WireGuard from the SkyLab Connect desktop client.

🛡️

Governance

TTL reclamation, idle detection, quotas, resource alerts and mining detection keep a shared cluster usable for everyone.

🤖

AI built in

An OpenAI-compatible AI API through LiteLLM and self-hosted vLLM models, plus assistants for administrators and teachers.

The administrator home page: node, VM and LXC counts, the AI operations assistant, and the lists of things to handle now and today.

Where to start

Running SkyLab for the first time: Getting started walks from docker compose up to the setup wizard and the first login.
Understanding the moving parts: Concepts and architecture explains the components, the roles and the vocabulary used across the UI and the guides.
Putting it on a server: Deployment covers secrets, the platform entry through the gateway, HTTPS, LDAP and CI deployment.
Something is wrong: Troubleshooting lists the failures people actually hit, with their causes and fixes.
Calling the API: REST API, WebSocket endpoints and the AI API user manual.
Looking for a specific page: the User manual covers every feature by role, and the documentation index lists every page by file.

SkyLab is free software released under the GNU AGPL-3.0; see License. This site is the documentation of the repository, kept under website/; the "Edit this page on GitHub" link at the bottom of each page opens the source file.