Repository navigation
Releases
SkyLab v1.0.0
First public release of SkyLab, a self-hosted cloud for schools on top of Proxmox VE: students request VMs, teachers spin up whole classrooms, admins keep the cluster under control.
SkyLab is a capstone project by five students at National Taipei University of Business (NTUB), Taiwan, and it runs at our school.
Highlights
- Request → approve → scheduled provisioning, with a capacity check for the requested time window
- Whole-class batch provisioning from a roster, including multi-machine lab environments
- Browser console: noVNC for VMs, xterm.js for LXC; students never see the PVE UI
- Firewall map, port forwarding and domain reverse proxy through a gateway VM (nginx + WireGuard + nftables)
- Governance: expiry dates, idle detection, quotas, crypto-mining detection, full audit log
- Multiple Proxmox connections (standalone nodes or clusters)
- Password, Google and LDAP/AD sign-in, optional per-account TOTP
- Optional OpenAI-compatible AI API in front of self-hosted vLLM models (via LiteLLM)
- UI in English, Traditional Chinese and Japanese
Install
Requirements: a Linux host with Docker Engine and Docker Compose ≥ 2.20, and a reachable Proxmox VE node or cluster.
git clone --branch v1.0.0 https://github.com/SkyLab-tw/SkyLab.git
cd SkyLab
cp -n .env.example .env
cp -n vllm-service/litellm/.env.example vllm-service/litellm/.env
# edit .env: at least SECRET_KEY, FIRST_SUPERUSER, FIRST_SUPERUSER_PASSWORD and POSTGRES_PASSWORD
docker compose up -d --build --scale litellm=0Then open http://localhost:8082. The setup wizard creates the administrator, tests the Proxmox connection, and configures the IP subnet, gateway and platform entry.
Upgrading an existing checkout
Back up the database and .env first, then:
git fetch --tags origin
git checkout v1.0.0
docker compose up -d --build --scale litellm=0Database migrations run automatically at startup. See Upgrading and migrations.
Links
- Documentation: https://docs.skylab-tw.com
- Website: https://skylab-tw.com
- The desktop client (SkyLab Connect) is released separately: https://github.com/SkyLab-tw/SkyLab-Connect/releases
Desktop Client v0.1.0 (moved to SkyLab-Connect)
Campus Cloud Connect 桌面連線工具(Electron + Vue 3 重寫版)
安裝
- 下載 campus-cloud-connect.zip
- 解壓縮到任意資料夾
- 雙擊 Campus Cloud Connect.exe
功能
- Device-code OAuth 登入
- frpc 隧道自動建立
- 一鍵 SSH 連線 VM