- JavaScript 40.5%
- Python 35%
- Shell 14.2%
- CSS 5.3%
- HTML 4.7%
- Other 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| addons | ||
| backend | ||
| data | ||
| frontend | ||
| scripts | ||
| .gitignore | ||
| Dockerfile | ||
| README.md | ||
CretaPanel
Server Management Panel & Declarative TOML App Store
Engineered for Rocky Linux (EL9 / EL10) and Container Workloads
A server management dashboard featuring a declarative TOML App Store, Docker container lifecycle management, system telemetry, and a glass-styled interface.
🌟 Key Features
-
Self-Hosting Container Architecture (
[apps.cretapanel]):- CretaPanel is managed like an app itself, running as a Docker container defined inside
data/apps.toml. - The kickstart script bootstraps CretaPanel into Docker on Rocky Linux without polluting the host OS with dependencies.
- Once running, CretaPanel recognizes its own container (
cp-cretapanel), allowing administrators to manage, inspect, configure, and upgrade CretaPanel from within its web interface.
- CretaPanel is managed like an app itself, running as a Docker container defined inside
-
Pure Declarative TOML App Catalog (
data/apps.toml):- The entire App Store is powered by human-readable, standard TOML files.
- 34 production-ready containerized applications pre-configured.
- Dynamic parameter schema generator renders custom UI input wizards for environment variables, ports, and volumes directly from the TOML specification.
- Built-in live TOML editor allowing sysadmins to add custom applications or community catalogs on the fly.
-
Sites: Static Web Hosting:
- Static web hosting: drop HTML, CSS, JS files or upload a production build ZIP (Vite, React, Vue, Next export, Hugo, Astro).
- Set a port and CretaPanel deploys an isolated Nginx Alpine container per site with Gzip, caching headers, and Single Page Application (SPA) fallback routing.
- Full In-Browser Code Editor & File Manager: inspect files, edit
index.html/style.css/script.jsdirectly with instant reload. - 4 Starter Templates: Glass Landing Page, Bio & Links, Single Page App, and Blank Site.
-
Glassmorphism Aesthetic:
- Translucent multi-layered frosted glass with specular edge reflections (
backdrop-filter: blur(24px) saturate(190%)). - Dynamic border gradients, ambient lighting orbs, and glass refraction on hover.
- Real-time Appearance Studio with interactive sliders for blur intensity (0px–48px), surface opacity, and color saturation.
- Translucent multi-layered frosted glass with specular edge reflections (
-
Curated Palette of 12 Wallpapers:
- 12 verified high-resolution abstract 3D fluid and chromatic glass wallpapers.
- 100% free for commercial and personal use under the Unsplash License with zero attribution required.
-
Rocky Linux Native Telemetry & Service Control:
- Enterprise Linux host diagnostics: Kernel version, CPU architecture, hostname, uptime, and load averages (1m, 5m, 15m).
- Real-time circular SVG gauges for CPU %, Memory %, Primary Disk Mounts, and Network RX/TX throughput.
- Firewalld and SELinux enforcement status visibility.
-
Autonomous Apps Fleet Lifecycle (Renamed from Containers):
- 1-Click deploy from TOML catalog.
- Supervised app fleet: Start, Stop, Restart, Remove, and Volume Purge.
- Colorized real-time streaming app logs.
- Host port conflict prevention and live telemetry per app.
-
Custom Panel Lock:
- Protect the entire control plane with a password from Appearance → Panel Lock.
- Uses a themed in-panel sign-in screen (not the browser's HTTP basic-auth dialog), with salted PBKDF2-SHA256 storage and HttpOnly session cookies.
- Every API endpoint is gated while locked, and sessions can be revoked instantly with Lock Now.
-
CretaPanel Addons (Git-Hosted Control Plane Extensions):
- Unlike containerized apps, Addons modify CretaPanel itself (Sites Engine, UI injection, routing daemons).
- Git-Only On-Demand Architecture: Addons live on the Git endpoint and are activated locally upon installation.
- Official Addons:
- Lokinet Sites (
lokinet-sites):- Automatically generates decentralized, end-to-end encrypted
.lokiSNapp addresses for all static websites deployed in CretaPanel. - Injects live onion domain badges and one-click copy links directly into the Sites view.
- Routes inbound Lokinet mesh traffic seamlessly to isolated Nginx containers.
- Automatically generates decentralized, end-to-end encrypted
- Tailscaled (
tailscaled):- Integrates the system's WireGuard mesh daemon with easy custom server configuration (Headscale or self-hosted control planes).
- Graphical coordination URL configuration (
--login-server), pre-auth keys (--auth-key), exit nodes, and subnet routes. - Live mesh telemetry: Tailscale IPv4/IPv6 badges, MagicDNS domain, interactive peer ping diagnostics, and device fleet discovery.
- Tor Sites (
tor-sites):- Transforms CretaPanel static sites into genuine v3 Tor Onion Hidden Services (
.oniondomains). - Anonymous, end-to-end encrypted, and censorship-resistant with zero port forwarding required.
- Supports Dual Clearnet Mode and Shielded Origin Mode (localhost-only origin binding to prevent clearnet IP leakage).
- Transforms CretaPanel static sites into genuine v3 Tor Onion Hidden Services (
- Lokinet Sites (
🖼️ Background Wallpapers Palette
| # | Name | Theme | Commercial License | Unsplash Photo URL |
|---|---|---|---|---|
| 1 | Obsidian Fluid | Liquid black obsidian & silver highlights | Free Commercial Use | Photo 1618005182384 |
| 2 | Prismatic Waves | Chromatic refraction in 3D fluid ribbons | Free Commercial Use | Photo 1634017839464 |
| 3 | Liquid Chromatic | Fluid caustics & holographic dispersion | Free Commercial Use | Photo 1620641788421 |
| 4 | Neon Glass Caustics | Glowing cyan & magenta glass refractions | Free Commercial Use | Photo 1550684848-fac1c5b4e853 |
| 5 | Ethereal Cyan Silk | Gentle turquoise fluid folds & glass sheen | Free Commercial Use | Photo 1618005198919 |
| 6 | Cyber Hologram | Holographic geometric 3D fluid render | Free Commercial Use | Photo 1635776062127 |
| 7 | Cosmic Glass Portal | Deep mystical violet & magenta fluid vortex | Free Commercial Use | Photo 1579783900882 |
| 8 | Aura Gradient Mist | Soft aura gradient transitions & frosted glass | Free Commercial Use | Photo 1579546929518 |
| 9 | Frozen Mercury | Molten chrome droplets & specular gloss | Free Commercial Use | Photo 1550684376-efcbd6e3f031 |
| 10 | Dark Nebula Swirl | Deep interstellar cosmic glass clouds | Free Commercial Use | Photo 1506703719100 |
| 11 | Subsurface Crystal | Translucent quartz mineral refractions | Free Commercial Use | Photo 1518709268805 |
| 12 | Midnight Aurora | Emerald green & sapphire waves in arctic sky | Free Commercial Use | Photo 1531366936337 |
📦 App Store Catalog (34 Applications Included)
- Cloud & Storage: Nextcloud Hub, FileBrowser, MinIO Object Store, Seafile Community.
- Media & Streaming: Jellyfin, Plex Media Server, Navidrome, Audiobookshelf.
- Networking, DNS & Security: Nginx Proxy Manager, Vaultwarden, AdGuard Home, Pi-hole, WireGuard Easy.
- Developer Tools: Gitea, VS Code Server (code-server), Portainer CE, IT-Tools, Dozzle.
- Databases & Caches: PostgreSQL 16, MariaDB 11.4, Redis Stack, MongoDB 7.0.
- Analytics & Monitoring: Uptime Kuma, Grafana, Prometheus, Netdata.
- Productivity & Smart Home: Home Assistant, Ghost Publishing, Paperless-ngx, Stirling-PDF, Trilium Notes, Thinkfree Office.
- Creative & Design: ArtCraft Suite (WordCraft, DeckCraft, PhotoCraft, VectorCraft, FilmCraft and more in one workspace).
🚀 Quickstart & Installation
Option 0: Ephemeral Testing Sandbox (Self-Destructs on Stop)
Want to test CretaPanel in your browser without permanently installing anything? Run the 1-line testing sandbox:
curl -fsSL https://git.new-eve.org/axoisaxo/cretapanel/raw/branch/main/scripts/test-install.sh | bash
Or locally from source:
./scripts/test-install.sh
This script:
- Installs CretaPanel into a temporary sandbox in
/tmp/cretapanel. - Runs the containerized control plane on port
8090(or8091). - You can test apps, change wallpapers, and customize TOML in your browser.
- Self-Destruct: As soon as you hit
Ctrl+Cin your terminal or click "Stop Container" in the Web UI, CretaPanel automatically stops, removes its container, deletes/tmp/cretapanel, and restores your host to a pristine state!
Option 1: Container Kickstart (Recommended for Rocky Linux)
Install CretaPanel as a permanent, self-managed Docker container:
curl -fsSL https://git.new-eve.org/axoisaxo/cretapanel/raw/branch/main/scripts/kickstart.sh | sudo bash
Or locally from source:
sudo ./scripts/kickstart.sh
This installer automatically:
- Detects Rocky Linux and ensures Docker Engine is active.
- Configures
firewalldto allow port 8090. - Seeds
/var/lib/cretapanelfor persistent volumes. - Builds or pulls
cretapanel:latest. - Deploys the control plane container as
cp-cretapanelwith self-management labels.
Option 2: Proxmox VE LXC Helper Script (Community-Scripts Standard)
Deploy CretaPanel directly onto your Proxmox VE host into a dedicated LXC container with full Docker and nesting support. Features interactive Whiptail dialogs with Default and Advanced (Custom Specs) modes:
Run this command in your Proxmox VE Host Shell:
bash -c "$(curl -fsSL https://git.new-eve.org/axoisaxo/cretapanel/raw/branch/main/scripts/proxmox-cretapanel.sh)"
Or from local source on your Proxmox node:
sudo ./scripts/proxmox-cretapanel.sh
Key Helper Script Capabilities:
- Default Mode: One-click instant setup (2 vCPU, 2048 MB RAM, 16 GB disk, Rocky Linux 10 default, DHCP, Privileged/nesting).
- Advanced Mode: Interactive customization of Container ID, Hostname, CPU cores, RAM, Swap, Storage pool selection (
pvesm status), Disk size, OS template (Rocky Linux 10 [Default] / Rocky Linux 9 / Debian 12 / Ubuntu 24.04), Network bridge, and Static/DHCP IP addressing. - Docker-Ready Virtualization: Configures
features: nesting=1,keyctl=1and handles Docker daemon bootstrapping. - Container Deployment: Automatically builds and launches
cp-cretapaneland verifies HTTP health on port 8090. - In-Container Maintenance: Installs
/usr/local/bin/cretapanel-updateand login shell MOTD inside the container.
Warning
Privileged Container Advisory: CretaPanel LXC uses Privileged mode by default so that Docker's
overlay2storage driver, network namespaces, and multi-user database volumes (PostgreSQL, MariaDB, Nextcloud) operate seamlessly without hostsubuidpermission errors. Because container root maps to host root, keep this container within a secured internal network or behind a reverse proxy. Unprivileged mode is also selectable under the Advanced menu.
Option 3: Direct Host Run (Development / Testing)
cd /home/axoisaxo/cretapanel
./scripts/start.sh
Open your browser at: http://localhost:8090
Option 4: Traditional Systemd Host Daemon
sudo ./scripts/install-rocky.sh
🔄 Updating CretaPanel from Git
CretaPanel includes dedicated update automation that pulls latest changes directly from Git (git.new-eve.org), rebuilds container images, and cleanly restarts the control plane with zero loss of persistent volumes or custom apps:
Method A: In-Panel 1-Click Web Update (No CLI Required)
- Open the CretaPanel Web Interface and navigate to the System tab.
- In the CretaPanel Control Plane card, click Check for Updates.
- When an update is available (or to rebuild/reinstall), click Update to [commit].
- The control plane downloads the latest package, rebuilds the container, and hot-swaps itself with live reconnect progress while keeping all your deployed apps and sites online without disruption!
Method B: From your Proxmox VE Host Shell (1-liner)
# Interactive menu (select 'Update') or direct flag:
bash -c "$(curl -fsSL https://git.new-eve.org/axoisaxo/cretapanel/raw/branch/main/scripts/proxmox-cretapanel.sh)" -- --update <CONTAINER_ID>
Or directly via pct:
pct exec <CONTAINER_ID> -- cretapanel-update
Method C: Inside the CretaPanel Container Console
Open the container console (pct enter <CONTAINER_ID>) and simply run:
creta update
Method D: Universal 1-Line Updater (Any Host / VM / Container)
curl -fsSL https://git.new-eve.org/axoisaxo/cretapanel/raw/branch/main/scripts/update.sh | sudo bash
🖥️ CretaPanel Management CLI (creta)
CretaPanel includes a built-in terminal CLI installed into system $PATH (/usr/local/bin/creta):
creta <command>
| Command | Action |
|---|---|
creta status |
Live telemetry (CPU/RAM %), API health check, active ports, and storage metrics |
creta update |
Pulls latest changes from Git, rebuilds image, and redeploys with zero data loss |
creta restart |
Restarts the CretaPanel control plane |
creta start |
Starts the CretaPanel control plane |
creta stop |
Stops the CretaPanel control plane |
creta logs |
Streams live colored logs from the control plane container |
creta apps |
Lists all running Docker containers deployed from the App Store |
creta sites |
Lists all hosted static sites and their active ports |
creta version |
Shows version (1.0.0-liquid), codename (Quartz Liquid), and Git commit hash |
creta help |
Displays the full command reference manual |
📝 Declarative TOML App Schema Example
Adding an app to data/apps.toml is as simple as defining this block:
[apps.mycustomapp]
id = "mycustomapp"
name = "My Custom App"
category = "Developer Tools"
tagline = "High-performance custom tool"
description = "Detailed description displayed in CretaPanel"
icon = "cpu"
accent_color = "#00d2d3"
version = "1.0.0"
website = "https://example.com"
developer = "Internal Team"
license = "MIT"
[apps.mycustomapp.container]
image = "mycustomapp:latest"
restart = "unless-stopped"
[[apps.mycustomapp.ports]]
host = 8080
container = 80
protocol = "tcp"
description = "Web Interface"
web_ui = true
[[apps.mycustomapp.volumes]]
host = "/var/lib/cretapanel/apps/mycustomapp/data"
container = "/data"
mode = "rw"
description = "Application State"
[[apps.mycustomapp.env]]
key = "APP_SECRET"
default = "creta_secret_key"
description = "Secret Encryption Key"
required = true
type = "password"
🛡️ License
CretaPanel code is licensed under the Apache 2.0 License.
All wallpaper assets are licensed under the Unsplash License (free for commercial and personal use).