Changelog
Release notes for VaultPanel: what was added, changed, fixed and secured in each version, up to 0.3.0.
All notable changes to VaultPanel. The format follows
Keep a Changelog, and versions follow
Semantic Versioning. Releases are the vX.Y.Z tags; the agent keeps its own
version (agent/Cargo.toml).
To update a server, see Updating.
Unreleased
Added
-
A more capable File Manager. Drag files onto the list to upload them, or pick several at once: they go up one after another with their progress listed, and names already in the folder are asked about once (replace them or skip them). Search the folder (
/), sort by name, size or date, show or hide hidden files, and type a path to jump to it. Select several items (Shift-click for a range) to download them as one zip, move them to another folder (created if needed), change their permissions (folders and files each get their own) or delete them. Every row has a menu, also on right-click, with Open, Download, Copy path, Rename, Move, Permissions, Compress, Extract and Delete; Del, F2, Ctrl/Cmd+A and Backspace work as shortcuts. The editor is wider, with line numbers, Tab and Shift+Tab indenting (Ctrl/Cmd+M switches Tab to moving focus), Ctrl/Cmd+S to save, the cursor's line and column, word wrap and a warning before unsaved changes are lost. Images open as a preview. Nothing changes on the servers: it uses the file operations agents already have. -
The panel speaks Arabic, Spanish, French, Swahili and Chinese (Simplified). Pick a language in the user menu, on the sign-in page, or under Account > Preferences, which also sets the time zone dates are shown in; both are saved to your account. Before sign-in the browser's language is used. Dates, times, numbers and sizes follow the language. Arabic is right to left: the layout mirrors, while code, commands, paths and addresses stay left to right. This release translates the sign-in pages, navigation, dashboard, account page, statuses, shared components and common error messages; other pages are still in English and follow in later releases (
npm run i18nlists them). Translators work on standard i18next JSON files (frontend/src/i18n/locales/); see docs/translating.md.
Changed
- The server agent is now written in Rust, and the Node.js agent is gone. The agent is one
program per CPU type (x86-64 and arm64),
/usr/local/bin/vaultpanel-agent, with nothing else to install on a server: no Node.js. It runs all of the panel's operations, speaks the same protocol (checked by the conformance suite on every change) and keeps the same config, registration, cron jobs and security model (its own user plus a root helper). Its version is0.42.0-rs.2.- The panel's own server moves to it by itself when the panel starts. Other servers move with the upgrade command on their page; Update agent and bulk updates work from then on, each server getting the program for its CPU type.
- The release builds the programs and puts them in the package (
agent/dist). A package built by hand needs them built first, orVAULTPANEL_PACKAGE_WITHOUT_AGENT=1. VAULTPANEL_AGENT_RUSTis gone (there is only one agent), and/api/v1/agent/package.tgzwith it.install-agent.shstill accepts--rustand ignores it.- The agent's code is in
agent/(it wasagent-rs/while both agents existed); its CI workflow is.github/workflows/agent.yml.
- Faster first load. Each page of the interface is now its own file, loaded the first time it is opened: the panel downloads 437 kB (128 kB compressed) to start instead of 1.6 MB (387 kB). After an update, a tab still open on the old version reloads once instead of failing to open a page.
- Accessibility (WCAG 2.2 AA). Text colours that were too faint now meet the contrast minimum in both themes (subtle grey, success, danger and warning text, the sidebar's group labels, white text on the active item and buttons), sortable table columns tell screen readers their order, copy buttons stay readable on light backgrounds, and a link that was only told apart by colour is underlined. Every main page passes axe-core's WCAG 2.2 A and AA checks in both themes; CI now checks it on each change.
VAULTPANEL_AGENT_REGISTER_LIMITsets how many agents may register per hour from one address (default 30), for connecting many servers at once from behind one address.- A new sign-in page. Sign-in, two-factor, password reset and the "address not allowed" page
share a new look: the form in a card on a dotted background, with monospaced fields and the
address you are signing in to above it (a green lock over HTTPS; "not encrypted" in amber over
plain HTTP). On wide screens a terminal beside it shows how to use the
vaultpanelCLI with this panel. "Forgot your password?" now sits under the password field. - Emails link to the panel domain. Invites, password reset links, alerts and the test email use
https://<panel domain>as soon as the domain on System > Panel Domain has a trusted certificate that covers it, without clicking Use https://… (which still decides agent install commands and webhooks, since other servers must reach the address). Until then they use the panel's IP address and port, as before. - Designed emails. Every email the panel sends now has an HTML version next to the plain text: the VaultPanel name, a clear heading, a button for the link (with the full link written out below it), a details table (account, panel, expiry; or event, server, time for alerts, with a coloured label for what happened) and a footer saying why it was sent. It adapts to phones and, where the mail app supports it, to dark mode. Messages queued before the update still go out as plain text.
- The documentation moved to docs.vaultpanel.net. The SSH login
message and
vaultpanel motdlink there for Documentation and Best Practices, instead of www.vaultpanel.net/docs/. Servers show the new links once their agent is updated. - Dark mode is neutral black, matching the documentation site: black background, near-black cards and sidebar, and gray borders and text instead of navy. The blue accent, the status colors and light mode are unchanged.
Fixed
-
The
vaultpanelCLI (0.1.2). Many commands sent requests the panel refused or quietly ignored. They now work:websites ssl(sends the contact email, the token owner's unless--emailis given)websites logs,apps logsandcontainers logs(print the log lines)apps env --set/--unsetapps rollbackwithout--release(picks the previous release still on the server)servers services(lists services, or checks, restarts, starts or stops one)databases create --user/--no-user(the password is shown once, even with--watch)databases users --databasecontainers deploy --port/--envcontainers list --allcontainers remove --remove-volumeswebsites delete --remove-filesbackups restore --no-safety-backup
--set,--unset,--env,--portand--querycan be repeated. Tables show the server, SSL state, process state and last run the panel actually returns, and job errors show their message. A new contract test runs every command against the API's real routes and validators. -
Email hosting uses a website's Let's Encrypt certificate (agent 0.42.0). Setting up the mail server looked for the certificate only under the host name's own folder, but websites keep theirs under
vp-<site>, so mail clients kept getting the server's self-signed certificate. It now uses any current certificate of a website that covers the mail host name. Set up the mail server again after updating the agent to switch to it. -
"Turn HTTPS off" no longer says the certificate is deleted. It is kept on the server, so HTTPS can be turned on again.
-
The servers list no longer nests the group links inside the server link (invalid HTML that confused screen readers and keyboard navigation).
Security
- Personal data tools for GDPR and similar laws. People download everything the panel holds about them under Account > Download my data; admins export anyone's, or erase a deactivated account, from Users. Erasing removes the person's name, email, sessions, tokens, conversations and preferences, and the audit log keeps what the account did without showing who they were. The audit log, kept forever until now, can keep entries for 90 days to 10 years (Audit log page); the database itself refuses to delete anything younger, and anything under 90 days. Exports and erasures are audited. docs/privacy.md lists the personal data a panel keeps, where it goes and for how long, and legal/dpa-template.md is a data processing agreement template for hosting providers.
- Third-party licences. Each package now installs THIRD_PARTY_LICENSES.txt
(
/usr/share/doc/vaultpanel) with the licence of every open-source package VaultPanel ships, the web interface's included; CI refuses a package under a licence that is not on the allowed list. - Backups are encrypted before they leave the server (agent 0.42.0). Copies sent to S3-compatible
storage or another server over SFTP are encrypted with AES-256-GCM, with a key per storage that the
panel makes and keeps encrypted; whoever can read the bucket sees only random bytes, and a changed
or truncated copy is refused when it comes back. Copies are stored as
<backup>.encand the backups list shows a lock on encrypted ones. Download each storage's key (Backups > Storage > Key) and keep it off the panel server: it is the only way to read the copies if the panel is lost, with the newvaultpanel backups decrypt <file> --key <key file>(CLI 0.1.3), which needs no panel. Servers whose agent is older keep copying unencrypted until they are updated; their copies say "not encrypted". - Rate limits are shared through Redis. The counters for sign-in, setup, password reset, agent registration, webhooks and the API are kept in Redis instead of each process's memory, so they hold when the API runs as several instances. If Redis cannot be reached, sign-in, setup, password reset and agent registration refuse requests instead of going unlimited.
- Signed checksums and an SBOM for every release. installer.vaultpanel.net publishes
SHA256SUMS(every package, the installer, the WHMCS module and the SBOMs) with a signature by the repository keyinstall.shalready trusts, and a CycloneDX software bill of materials of the npm packages each release ships (releases/vaultpanel-<version>.cdx.json). security.txtatdocs.vaultpanel.net/.well-known/security.txt(RFC 9116) tells researchers how to report a problem privately.
0.3.0
Released November 10, 2026.
Added
- A free AI model on the panel's own server (agent 0.41.0). System > Assistant Settings has a
third choice, Free model on this server: pick a small open model from the list (it shows each
one's download size and the memory it needs next to the server's free memory and disk) and click
Install. The agent installs Ollama (a fixed release, checked against its SHA-256), runs it as
its own service on
127.0.0.1:21434, and downloads the model, with the progress shown as it goes. The assistant then answers with no API key and nothing leaves the server, more slowly and more simply than Claude. Only the panel and root can reach the model: a firewall rule refuses websites, apps and other accounts on the server. Models, or Ollama itself, can be removed again from the same page.
Changed
- Each AI provider keeps its own settings. Switching the assistant between Claude, an OpenAI-compatible service and the free model on this server keeps each one's model, address and API key, so switching back needs nothing again (before, switching deleted the saved key).
0.2.1
Released November 10, 2026.
Changed
- The sidebar follows the usual control-panel order: Overview and the AI Assistant first; then Infrastructure, Web, Applications and Data & Files; then Monitoring (a new section with Monitoring, Alerts, Logs and Jobs, which were under Infrastructure) and Automation; then Security, Hosting and Users & Access; installed plugins' pages; and System last, which now also holds Assistant Settings. Pages name the section they are in above their title.
0.2.0
Released November 9, 2026.
Security
- The panel no longer runs as root.
vaultpanelandvaultpanel-workerrun as the new unprivilegedvaultpaneluser inside a systemd sandbox (ProtectSystem=strict, no capabilities,NoNewPrivileges, private/tmpand devices). Only connecting the panel's own server (theconnectLocal.jsstep before the API starts) runs as root..envand the TLS key are readable, not writable, by the panel. - HTTPS from the first start. New installs serve the panel over HTTPS on its own port with a
self-signed certificate (like Cockpit, Webmin or Proxmox), so passwords and the setup token never
cross the network in clear. Plain HTTP stays available on
127.0.0.1only (VAULTPANEL_LOOPBACK_PORT) for the local agent, the panel domain's NGINX and thevaultpanelcommand. HSTS is only sent where the certificate is trusted (a panel domain), never on an IP address or the self-signed port. - Pinned agent installs. With the self-signed certificate, the "Add server" and upgrade
commands carry the certificate's public key pin (
curl --pinnedpubkey,--panel-pin). The agent installer checks the pin, saves the certificate as/etc/vaultpanel-agent/panel-ca.pemand the agent trusts exactly it (NODE_EXTRA_CA_CERTS), so servers can be added safely without a domain. Adding a server to a default install used to need a domain or a hand-edited command. - Webhooks and plugins no longer reach private networks by default
(
VAULTPANEL_WEBHOOK_ALLOW_PRIVATE=false). Panels installed earlier keep their previous behaviour. - The panel's files moved from
/var/lib/vaultpanel(which also holds the agent's private state) to/var/lib/vaultpanel/panel, owned by the panel's user. - True/false settings left out of
.envwere read as on. Their defaults came through as the text"false", which counts as true. Every panel that install.sh set up lacksVAULTPANEL_PLUGIN_ALLOW_LOCAL, so its plugins could reach the panel's own server and private networks; a panel withoutVAULTPANEL_ALLOW_INSECURE_AGENTSorVAULTPANEL_WEBHOOK_ALLOW_PRIVATEin.envaccepted agents over plain HTTP or let webhooks reach private networks. Settings left out take their documented defaults again. - Agent downloads are rate limited: 60 a minute per address for the agent's install script, package and the panel's certificate, which need no sign-in. The package is built for each download, so endless requests could keep the panel busy. A server installing or updating its agent downloads each once.
Added
- Choose the database for websites and apps when installing.
DB_ENGINE(or--db-engine) installs MariaDB 12.3, 11.8, 11.4, 10.11 or 10.6, as each system offers them (see the README), on port 3306: from the system's own packages when they have that version, else from MariaDB's repository, whose signing key is checked against MariaDB's fingerprint. A new install gets the newest MariaDB for its system unlessDB_ENGINE=NONE; a server that has a database server keeps it, and updates never change it. The summary shows it. MySQL 8.4 and 8.0 come later. - VaultPanel installs from packages, like CloudPanel. Each release builds the
vaultpanelpackage (vaultpanel_X.Y.Z_all.deb: the panel ready to run, with its Node.js packages and the built web interface) and publishes it, signed with VaultPanel's key (fingerprint79B34D79D2A7D0DE54A3D906B62A47C2ED2775A6), to VaultPanel's APT repository on the public site https://installer.vaultpanel.net (the VaultPanel/packages repository, GitHub Pages), with that release's installer atv2/install.sh, the WHMCS module and a README with the install command and the installer's checksum. The installer sets up Node.js, Docker and MariaDB, adds the repository after checking its key's fingerprint and runsapt install vaultpanel; servers no longer download from GitHub or build anything. The package sets the panel up on install and on every upgrade (install.sh --configure), backs it up before an upgrade, and removes its services when removed.vaultpanel updateandapt upgradeinstall newer packages;vaultpanel rollbackrestores the backup and installs the previous version again (the repository keeps the newest 5). Installing from a copy of the repository, which stays git based, is for trying unreleased code. The Release workflow builds the package, installs it on a fresh runner from a signed copy of the site following the published install command (the Package workflow, also run for changes to packaging), and only then publishes it; pre-releases are not published. Shell scripts and the package's scripts keep LF line endings in Windows checkouts (.gitattributes). - Ubuntu 26.04 LTS is supported by the installer.
- Back up a website's or app's database from its page. Back up now asks what to back up:
on the Backups page Website files, App files or a Database; on a website's or app's
Backups tab its Files or one of its Databases. That tab now lists the backups and
schedules of its databases with its own, each marked Files or with the database's name, and
Add schedule schedules either. Databases can be linked to the website that uses it, as they
can to an app: For website when creating one, or Link on the Databases page. Databases
made by the app installer (WordPress, Joomla, Drupal, Laravel) are linked to their website,
including those installed before. API:
websiteIdonPOST/PATCH /databases(a link left out ofPATCHis now kept) andGET /databases,includeDatabases=trueonGET /backupsandGET /backup-schedules. No agent update needed. - Server self-check (agent 0.39.0). Every 5 minutes each agent checks what the panel's features
need from its server: the root helper answers, everyone can read the agent's code, the file
manager's worker starts as a site user,
nginx -tandapache2ctl -tpass, Certbot's renewal timer runs, the clock is synchronized and no systemd unit has failed. The server's Overview shows them on a Self-check card, with Check now and the command that fixes each failure. A new default alert rule, Server self-check failed, sends the usual alert emails and webhooks when a check fails for 10 minutes; warnings (agent running as root, Certbot timer, clock, failed units) only show on the card. - WHMCS module (
integrations/whmcs). Sell VaultPanel hosting from WHMCS: each service is a VaultPanel account that WHMCS creates, suspends, unsuspends, upgrades, terminates and sets the password of, with a plan dropdown read from the panel, Log in to VaultPanel (single sign-on), disk usage in WHMCS, a client-area overview and an admin tab. The billing API gainsGET /billing/accounts(accounts with usage) andPOST /billing/accounts/{ref}/login, a sign-in link that works once within two minutes (opened on the new/ssopage). - Website uptime monitoring. The panel checks every website the way visitors reach it, every 5
minutes by default (
VAULTPANEL_UPTIME_CHECK_SECONDS): over HTTPS when the certificate covers the domain, judging the certificate it serves like a browser. A failure is checked again 10 seconds later before the website counts as down. The website's Overview shows Up or Down, uptime over 24 hours, 7 and 30 days, response time, the served certificate's expiry and recent downtime, with Check now and a switch to turn monitoring off; the Websites list marks sites that are down. A new default alert rule, Website down, sends the usual alert emails and webhooks. History is kept 30 days (VAULTPANEL_UPTIME_HISTORY_DAYS). - Wildcard certificates through Cloudflare or Namecheap (agent 0.38.0). Domains whose DNS is at Cloudflare or Namecheap get Let's Encrypt wildcard certificates without moving their DNS to the panel: staff save the provider's API credentials once under Web > DNS Zones > DNS providers (stored encrypted), then choose it under Check DNS through on a website's SSL tab. The agent adds the check record through the provider's API, waits until the domain's name servers serve it, and keeps the credentials root-only so Certbot's renewals work too. For Namecheap, whose API replaces all records at once, every record and the email setting are written back exactly as read, and nothing is written when they cannot all be read.
- Wildcard website domains (agent 0.37.0). A website or app can list
*.example.comamong its domains to serve every subdomain that no other site lists (exact names still win, soadmin.example.comcan be a site of its own). A Let's Encrypt wildcard certificate covers it; a normal certificate covers the site's other domains and leaves the wildcard out. Wildcards over a registry suffix (*.co.uk) are refused, and a hosting customer's wildcard keeps other accounts off the names under it. vaultpanel backup,vaultpanel restoreand a dailyvaultpanel-backup.timer: the panel's database, settings, secret key, HTTPS certificate and terminal recordings in one archive, with retention, checksums, optional encryption (VAULTPANEL_BACKUP_PASSPHRASE_FILE) and an optional copy-off-the-server command (VAULTPANEL_BACKUP_UPLOAD). Restores work on a new server for disaster recovery (the new server keeps its own database passwords).- Versioned installs:
install.sh --version vX.Y.Z(default: the latest release),vaultpanel update [--version ...], which backs the panel up first, andvaultpanel rollback, which goes back to the previous version and its database. vaultpanel https [status|on|off|renew]to manage the panel's own certificate, andinstall.sh --https/--http.- A Release workflow that publishes tagged versions with
SHA256SUMSand build provenance. - End-to-end smoke tests (Playwright) and test coverage in CI; Dependabot, CodeQL and
npm audit. LICENSE,SECURITY.md,CONTRIBUTING.md, issue and pull request templates.
Changed
- VaultPanel is proprietary, under the VaultPanel License (
LICENSE): free to install and use, also to host customers, but not to copy, change, resell or redistribute. Its source code is private; the public VaultPanel/packages repository holds the installer, the packages and the issues. Versions published while the repository was public stay under the license they came with (MIT, then for a short time AGPL-3.0). The SDK, the CLI, the WHMCS module and the example plugin stay MIT, with their ownLICENSEfiles; the WHMCS module is now downloaded from installer.vaultpanel.net. Security reports go to VaultPanel/packages. - NodePanel is now VaultPanel (agent 0.40.0). The new name is used everywhere: the interface,
emails, login banners and docs; the
vaultpanelcommand and CLI; the@vaultpanel/*packages; thevaultpaneluser, services (vaultpanel,vaultpanel-worker,vaultpanel-agent,vaultpanel-agent-helper,vaultpanel-backup.timer) and folders (/opt/vaultpanel,/opt/vaultpanel-agent,/etc/vaultpanel-agent,/var/lib/vaultpanel…);VAULTPANEL_*settings; thevaultpaneldatabase and Docker project; theX-VaultPanel-*headers of agents, webhooks and plugins;io.vaultpanel.*container labels; thevaultpanelDKIM selector; and the WHMCS module (modules/servers/vaultpanel). The short prefixes changed with it: tokens and keys start withvpt_,vpk_,vpe_andvpp_, plugin links carryvp_*parameters, and the accounts the agent creates are namedvp-…. Nothing converts a NodePanel install, its agents or its tokens: remove NodePanel, install VaultPanel and add each server again. - Agent install commands for a plain-HTTP panel that accepts HTTP agents now include
--insecure-http, so they work as copied. - A panel domain set up while the panel used plain HTTP is moved to the loopback port automatically when HTTPS is turned on.
Fixed
- A new panel's address opened the sign-in page, with no account to sign in with yet. It now opens the setup page, where the owner account is created.
- Searching a list (websites, apps, databases, users, servers, backups, the audit log…) for text
with a backslash (
\) in it found the wrong things: the backslash changed the search. Found by CodeQL, as were a few other escapes and checks made stricter. - Invite and password-reset pages only accept invite and reset links (
password_reset_tokensnow also holds one-time sign-in links, which must never set a password). - The file manager failed on the panel's own server with "Cannot find module
'/opt/vaultpanel-agent/src/services/fileWorker.js'". The panel's
UMask=0077reached the agent installer it runs, leaving/opt/vaultpanel-agentreadable by root only, so the worker (which runs as the site's user) and the agent's own user could not load it. The installer now setsumask 022and makes the agent's code readable by everyone, updates from the panel do the same (agent 0.37.0), and the panel installs its own server's agent again when it starts and finds it readable by root only. - Docs that still listed email for invites, password resets and alerts as not built (it is: System > Panel Email).