NewImprovedFixedSecurity

v2.9.21

Deploy Node.js Apps With pnpm, Yarn or Bun From Git

Deploy via Git now installs your Node.js app with the package manager your repository already uses. Migrations no longer touch a site on the server that xCloud does not manage. You also get an alert when a Docker site’s container stops.

🔥 New Features

🆕 Use pnpm, Yarn or Bun With Deploy via Git

Before, xCloud installed every Node.js app with npm. Projects built on pnpm, Yarn or Bun needed edited build scripts or a switch to npm. Now xCloud reads your repository and uses the package manager it finds.

Who it’s for: Developers who deploy Node.js apps from Git.

  • xCloud reads the packageManager field in package.json first, then the lockfile (pnpm-lock.yaml, yarn.lock, bun.lock or bun.lockb, package-lock.json). With neither, it uses npm.
  • Under the Node.js version, the site wizard shows the package manager it found, for example Package manager: pnpm 9 (found in the repository).
  • Dependencies install with that package manager, and the build runs with it too, for example pnpm run build.
  • If your repository has lockfiles from two package managers, xCloud uses npm and shows Two lockfiles found; npm is used.
  • Repositories that use npm deploy exactly as before.

How to Deploy a Node.js Application with xCloud

🧑‍💻 For Developers: Public API and MCP

  • Shorter tool list by default: the plain https://app.xcloud.host/mcp address now serves the unified tool set (search, execute, docs and todos_index) to everyone, instead of one tool per operation. Use ?profile=flat to keep the full list.
  • Old tool names: an agent that calls an old flat tool name, such as api_server_notes, on the unified address is now told which operation to run with execute.
  • Agents ask before more live changes: 18 more operations now answer with a preview first and run only after you confirm. They cover a site’s web root, redirects, header and redirect rule order, Laravel maintenance, debug and environment settings, Cloudflare security rules and Under Attack Mode, blocking or allowing an IP, the AI crawler blocker, full page cache and Redis object cache, nginx upgrades, PHP extensions, php.ini limits and the OpenLiteSpeed group cache patch.
  • Previews you can trust:
    • A preview now names the site’s server and flags a target your team cannot find.
    • A preview is refused up front when the confirm would refuse your role or permission.
    • A dry run of a guarded create, such as a new site, now returns its fingerprint, so one confirmed call runs it.
    • A value outside an operation’s allowed list is refused with invalid_arguments, naming the allowed values. Nothing runs.
  • Honest answers: an operation the app refuses now reports success: false with a code and a next step. Before, it could say it succeeded.
  • Team create over MCP: agents can no longer create a team they then cannot see or reach.
  • Faster search: unified search makes far fewer database calls, and meta.took_ms now reports the whole search time.
  • File uploads: agent search now finds the upload and static-site workflow, so agents use the site file tools instead of SSH.
  • Demo domains: GET /servers/{uuid}/staging-hostname now lists xc1.app for non-WordPress sites, as the dashboard does. Blank, Git and Git Docker creates refuse a demo domain that is not offered.
  • Deploy diagnosis: sites.deploy-diagnosis now names the failed install or build step for deploy scripts made by the site wizard. Before, it always pointed at the deploy script.
  • Hermes restart: restarting Hermes through the API now also restarts its dashboard, like the dashboard’s restart button.
  • White Label teams: API access for members of a White Label customer team now follows the same permissions as the dashboard.
  • Enterprise API: a read-only token, for example read:servers or read:addons, can again use the read routes its scope covers. Writes and sub-user login links still need full access.

See How to Connect xCloud MCP to Your AI Agent.

🔒 Security

  • White Label custom domain: your custom domain goes live only after xCloud finds a DNS TXT record that proves you own it. Add the record shown in Reseller → Settings → Domain, then click Verify Ownership. A pending domain expires after 7 days. See How to Setup Your Reseller Account with xCloud White Label.
  • Team permissions:
    • Opening the terminal of an OpenClaw, Hermes or Paperclip site now needs the server’s root terminal permission, because these sites run as admin.
    • Buying a plan with the team’s credit or saved card now needs billing permission. Other members see “You do not have permission to buy a plan for this team.”
    • Buying mailboxes, setting forwarding, adding aliases, upgrading plans and running mailbox migrations now need permission to create or update add-ons. View-only members can no longer do them.
    • Updating n8n restarts every n8n site on the server, so it now needs access to all of them.
    • Save & Restart MySQL on the Slow Query Log tab restarts MySQL for every site on the server, so it now needs the server’s database permission.
    • A member can continue a migration only for a site they are allowed to manage.
  • AI agent servers: archiving an OpenClaw, Paperclip, Hermes or DeepSeek server now keeps its sites, so restoring the server brings them back.
  • Support conversations: your support conversations link to your team only through a confirmed team email. When you change the team email, xCloud mails a link to confirm the new address.
  • Saved cards: a card added on the hosted checkout page is now saved only to the team it belongs to.
  • Docker restores: the safety copies a restore keeps are now stored in a folder only the server admin can reach.
  • OpenLiteSpeed sites: sites now accept only strong TLS 1.2 ciphers, and the HTTP to HTTPS and www redirects now carry the security headers you set in Site Rules.

⚡ Improvements

  • Docker sites: you now get a Docker Container Down alert when a live Docker Compose site’s container has stopped, a reminder every hour while it stays down, and an alert when it is back.
  • Server backup restore: the restore dialog now warns that “Sites you deleted after this backup will come back on the server but won’t show in xCloud.” After a restore, the server page lists any such sites it finds.
  • Backups: backup history now shows the server’s time zone next to each time, for example 15 Nov 2026 3:55 PM UTC.
  • Checkout: the total shows the regular price struck through beside what you pay, and You’re saving is easier to spot.
  • PostgreSQL: on an OpenLiteSpeed server, the message now tells you to use or choose an Nginx server for managed PostgreSQL.
  • Fix with AI: asking the assistant to fix a To-Do item now shows the approval card straight away, instead of asking again in words.

🐞 Bug Fixes

  • Site migrations
    • A migration no longer uses a domain that already has a site on the server. It shows “This domain already has a site on this server.”
    • A migration no longer reuses the Linux user, database or database user of a site already on the server.
    • Cancel Migration and Delete Migration now remove only what the migration created, and Delete Migration asks you to confirm first.
  • Git and Node.js deploys
    • Git deploys now keep WordPress files that sit under a web root folder, such as public/ or web/, including Bedrock.
    • A Git deploy now checks for free disk space before copying files, and stops with a clear message if there is not enough.
    • A deploy that was stopped halfway now gets its kept files back on the next deploy.
    • Release-mode Node.js deploys no longer fail at random with “The inactive Node listener does not belong to this site’s PM2 app”.
    • Generate with AI now writes a deploy script for repositories with files in older text encodings. Before, it fell back to the default script without saying so.
  • Servers
    • Site creation, SSL and domain changes no longer fail on servers with many sites.
    • Ubuntu’s PHP packages on OpenLiteSpeed servers now get their nightly security updates again.
    • After a server moves to another team, Cloudflare actions use the new team’s own connected Cloudflare account.
  • AI agent sites
    • Restarting OpenClaw from the server’s services list now checks that it really restarted.
    • Update Now for Hermes now updates the copy of Hermes that is actually running.
  • Billing and account
    • Mailbox bills and invoices now name the paid plan, for example 8GB ($1/month), instead of Unknown Plan.
    • The Servers and Add-ons tab counts in Settings → Servers & Add-ons now include purchases waiting for setup.
    • The sign-up form now shows This field is required. under each empty field instead of sending an empty form.
  • Dashboard
    • The resize edge of the To-Do drawer and the assistant panel no longer shows a dark line.

Please note

  • White Label resellers: a new or changed custom domain stays pending until you add its TXT record and click Verify Ownership.
  • MCP users: if your AI client relied on the full tool list at the plain /mcp address, add ?profile=flat to keep it.