No description
  • JavaScript 40.5%
  • Python 35%
  • Shell 14.2%
  • CSS 5.3%
  • HTML 4.7%
  • Other 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-04 14:43:34 +01:00
addons fix(tailscaled): resolve container detection, add live interactive browser auth with login links, and fix undefined hostname 2026-10-11 20:10:32 +02:00
backend feat: add Craft apps and custom panel lock 2026-11-04 14:33:56 +01:00
data feat(catalog): replace Craft apps with ArtCraft Suite 2026-11-04 14:43:34 +01:00
frontend feat(catalog): replace Craft apps with ArtCraft Suite 2026-11-04 14:43:34 +01:00
scripts feat: add Craft apps and custom panel lock 2026-11-04 14:33:56 +01:00
.gitignore feat: add Craft apps and custom panel lock 2026-11-04 14:33:56 +01:00
Dockerfile feat: add Craft apps and custom panel lock 2026-11-04 14:33:56 +01:00
README.md feat(catalog): replace Craft apps with ArtCraft Suite 2026-11-04 14:43:34 +01:00

CretaPanel Logo

CretaPanel

Server Management Panel & Declarative TOML App Store

CretaPanel Dashboard

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

  1. 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.
  2. 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.
  3. 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.js directly with instant reload.
    • 4 Starter Templates: Glass Landing Page, Bio & Links, Single Page App, and Blank Site.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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 .loki SNapp 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.
      • 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 (.onion domains).
        • 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).

🖼️ 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:

  1. Installs CretaPanel into a temporary sandbox in /tmp/cretapanel.
  2. Runs the containerized control plane on port 8090 (or 8091).
  3. You can test apps, change wallpapers, and customize TOML in your browser.
  4. Self-Destruct: As soon as you hit Ctrl+C in 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!

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:

  1. Detects Rocky Linux and ensures Docker Engine is active.
  2. Configures firewalld to allow port 8090.
  3. Seeds /var/lib/cretapanel for persistent volumes.
  4. Builds or pulls cretapanel:latest.
  5. Deploys the control plane container as cp-cretapanel with 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=1 and handles Docker daemon bootstrapping.
  • Container Deployment: Automatically builds and launches cp-cretapanel and verifies HTTP health on port 8090.
  • In-Container Maintenance: Installs /usr/local/bin/cretapanel-update and login shell MOTD inside the container.

Warning

Privileged Container Advisory: CretaPanel LXC uses Privileged mode by default so that Docker's overlay2 storage driver, network namespaces, and multi-user database volumes (PostgreSQL, MariaDB, Nextcloud) operate seamlessly without host subuid permission 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)

  1. Open the CretaPanel Web Interface and navigate to the System tab.
  2. In the CretaPanel Control Plane card, click Check for Updates.
  3. When an update is available (or to rebuild/reinstall), click Update to [commit].
  4. 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).