# CloudPress Documentation

> CloudPress is a managed WordPress hosting platform. Whether you run your sites from the dashboard or build an integration, start here.

The full text of every page is at https://docs.cloudpress.com/llms-full.txt. Each link below points to the Markdown version of a page (append `.md` to any page URL). Human-readable site: https://docs.cloudpress.com/.


## Get started

- [Get started](https://docs.cloudpress.com/get-started/index.md): Onboarding guides from sign-up to a running WordPress site: placing your first order, accessing files and the database, inviting teammates, and connecting an AI assistant.
- [Placing your first order](https://docs.cloudpress.com/get-started/placing-your-first-order.md): Create your first WordPress site on CloudPress from the dashboard — choosing a plan and region, optionally registering a domain, paying, and watching the site provision.
- [Accessing your files](https://docs.cloudpress.com/get-started/accessing-your-files.md): Three ways to reach a CloudPress site's files — the Cloud Shell web terminal, the web File Manager, and an SFTP or SSH connection from your own computer.
- [Accessing your database](https://docs.cloudpress.com/get-started/accessing-your-database.md): Open phpMyAdmin for a CloudPress site with one click from the dashboard to browse tables, run queries, and export data — with no credentials to copy.
- [Inviting a user to your workspace](https://docs.cloudpress.com/get-started/inviting-a-user.md): Invite a teammate to a CloudPress workspace by email, choose the role they get, and see what the invitation looks like from their side.
- [Connecting to our MCP server](https://docs.cloudpress.com/get-started/connecting-to-mcp.md): Connect an AI assistant like Claude or OpenAI Codex to CloudPress over MCP — add the server, authorize it once, then manage your sites, DNS, and domains by chat.

## Guides

- [Guides](https://docs.cloudpress.com/guides/index.md): Step-by-step instructions for managing CloudPress from the dashboard — WordPress sites, Mailspace mailboxes, cPanel hosting, domains, the CDN and Shield, billing and users, and advanced server configuration.

### WordPress sites

- [Changing the PHP version](https://docs.cloudpress.com/guides/sites/changing-php-version.md): Switch your CloudPress site to a different available PHP version from the dashboard, and know what to expect while the change applies in the background.
- [Scheduled tasks (cron)](https://docs.cloudpress.com/guides/sites/cron.md): WordPress scheduled tasks run automatically; add your own scheduled commands with your site's crontab file.
- [Viewing logs](https://docs.cloudpress.com/guides/sites/viewing-logs.md): Where to read a CloudPress site's logs — CDN access logs, error and access logs in the Log Viewer, Shield security events, and the raw Nginx files over SFTP or SSH.
- [Site activity](https://docs.cloudpress.com/guides/sites/activity.md): Read a site's Activity page — the read-only history of what was done to it, who requested each action, and how it finished.
- [Backing up and restoring a site](https://docs.cloudpress.com/guides/sites/backups.md): Take an on-demand backup of a CloudPress site, restore it from any backup, download a backup archive to your computer, and delete backups you no longer need.
- [Transactional email](https://docs.cloudpress.com/guides/sites/transactional-email.md): Set up and check the mail your WordPress site sends by itself, such as password resets and order confirmations: DNS records, sending logs, and what to do if sending is blocked.
- [Deleting and restoring a site](https://docs.cloudpress.com/guides/sites/deleting-and-restoring-a-site.md): Delete a CloudPress site, restore it during the retention period by buying it again, or delete it permanently right away.

### Mailspace

- [Mailspace: overview](https://docs.cloudpress.com/guides/mailspace/index.md): What Mailspace is, how it differs from a site's Transactional Email, what a mailspace contains, and where to go next in this section.
- [Ordering a Mailspace](https://docs.cloudpress.com/guides/mailspace/ordering-a-mailspace.md): Order Mailspace mailbox hosting for a domain — choosing a mail plan, picking the domain, paying, and what you see while the mailspace is created.
- [Verifying your domain](https://docs.cloudpress.com/guides/mailspace/verifying-your-domain.md): Prove you own a domain before CloudPress hosts mail for it, by publishing the DNS TXT record the dashboard shows you.
- [Managing mailboxes](https://docs.cloudpress.com/guides/mailspace/managing-mailboxes.md): Create a mailbox on your own domain inside a Mailspace, change its settings and password, and remove one you no longer need.
- [Connecting a mail client](https://docs.cloudpress.com/guides/mailspace/connecting-a-mail-client.md): Find a Mailspace mailbox's IMAP and SMTP settings in the dashboard, and create an app password so a mail app has a credential of its own.
- [Aliases, groups and masked emails](https://docs.cloudpress.com/guides/mailspace/aliases-groups-and-masked-emails.md): Create Mailspace aliases, groups and masked emails: extra addresses that deliver into a mailbox without being one.
- [Mailing lists](https://docs.cloudpress.com/guides/mailspace/mailing-lists.md): Create a Mailspace mailing list — one address that fans mail out to several recipients, inside the mailspace or anywhere else — then change or delete it later.
- [Mail rules and out of office](https://docs.cloudpress.com/guides/mailspace/mail-rules-and-out-of-office.md): Create rules that sort a Mailspace mailbox's incoming mail, put them in order, and set an out-of-office reply for while you're away.
- [Mail logs](https://docs.cloudpress.com/guides/mailspace/mail-logs.md): Use a Mailspace's Logs page to see whether a message arrived, was sent, is still queued, or bounced, and why.
- [Storage and deleted mail](https://docs.cloudpress.com/guides/mailspace/storage-and-deleted-mail.md): See how much mail storage a Mailspace is using, what to do if you go over, and how to restore deleted mail from Deleted Emails.
- [Deleting and restoring a Mailspace](https://docs.cloudpress.com/guides/mailspace/deleting-and-restoring-a-mailspace.md): Delete a Mailspace, restore it within 7 days by buying it back, or remove it permanently.

### cPanel accounts

- [cPanel hosting: overview](https://docs.cloudpress.com/guides/cpanel/index.md): What cPanel hosting is on CloudPress, how it differs from a managed WordPress site, who it suits, and how to tell whether your workspace has it enabled.
- [Ordering cPanel hosting](https://docs.cloudpress.com/guides/cpanel/ordering-cpanel-hosting.md): Order a cPanel hosting account from your CloudPress workspace — picking a package and billing term, setting the main domain, paying, and watching the account provision.
- [Logging in to cPanel](https://docs.cloudpress.com/guides/cpanel/logging-in-to-cpanel.md): Open the cPanel control panel from your CloudPress dashboard with one click, find the connection settings in Login details, and work out what to do when the login fails.
- [Managing domains](https://docs.cloudpress.com/guides/cpanel/managing-domains.md): Add addon, alias and subdomain domains to a cPanel hosting account, and remove them again.
- [Changing your cPanel password](https://docs.cloudpress.com/guides/cpanel/changing-your-password.md): Set a new password for a cPanel hosting account from the CloudPress dashboard, what that password unlocks and what it doesn't, and how to change it over the REST API instead.
- [Resizing your cPanel package](https://docs.cloudpress.com/guides/cpanel/resizing-your-package.md): Move a cPanel hosting account to a larger or smaller package, and see what you pay or get credited.
- [Deleting and recovering a cPanel account](https://docs.cloudpress.com/guides/cpanel/deleting-and-recovering-an-account.md): Delete a cPanel hosting account, bring it back within 7 days, or remove it permanently.

### Domains

- [Adding a domain to a site](https://docs.cloudpress.com/guides/domains/adding-a-domain-to-a-site.md): Connect a domain to a CloudPress site, whether you already own it, register it or transfer it in, and follow its progress until it is live over HTTPS.
- [Purchasing a domain](https://docs.cloudpress.com/guides/domains/purchasing-a-domain.md): Buy a domain from the CloudPress dashboard — searching for availability, adding it to your cart, entering registrant contact details, and paying.
- [Transferring a domain](https://docs.cloudpress.com/guides/domains/transferring-a-domain.md): Move a domain in from another registrar, out to another registrar, or across to another CloudPress customer with a push transfer.
- [Managing DNS](https://docs.cloudpress.com/guides/domains/managing-dns.md): View and edit the authoritative DNS zone CloudPress hosts for your domain — adding, changing, and deleting records, and turning DNSSEC on or off.

### CDN & Shield

- [Shield: overview](https://docs.cloudpress.com/guides/shield/index.md): What Shield does at the edge — WAF, DDoS mitigation, bot detection, and rate limiting — how to activate it for a site, which plans include it, and where to review its security events.
- [Shield: WAF rules](https://docs.cloudpress.com/guides/shield/waf-rules.md): Turn on Shield's Web Application Firewall, choose how strictly it runs, tune the built-in managed rules, and write custom WAF rules of your own.
- [Shield: bot protection](https://docs.cloudpress.com/guides/shield/bot-protection.md): Turn on Shield's Bot Detection to log or challenge automated traffic, choose an execution mode, and tune how sensitive each detection signal is.
- [Shield: rate limiting](https://docs.cloudpress.com/guides/shield/rate-limiting.md): Cap how many requests a single client can make to your site within a time window using Shield rate-limit rules, then edit or delete them later.
- [Shield: access lists](https://docs.cloudpress.com/guides/shield/access-lists.md): Allow or block traffic to your site by IP address, network range, or country with Shield access lists, and turn on the curated threat lists we maintain for you.
- [Managing edge rules](https://docs.cloudpress.com/guides/shield/managing-edge-rules.md): Create CDN edge rules that act on a request before it reaches WordPress — redirects, forced HTTPS, country and IP blocks, cache overrides, and response headers.

### Account & billing

- [Adding a payment method](https://docs.cloudpress.com/guides/account/adding-a-payment-method.md): Save a card to your CloudPress account from the Billing area or during checkout, so renewals and new purchases are charged automatically.
- [Viewing invoices](https://docs.cloudpress.com/guides/account/viewing-invoices.md): Browse past invoices in the CloudPress dashboard, open one for its line items and totals, and download a PDF for your records.
- [Changing a subscription's payment method](https://docs.cloudpress.com/guides/account/changing-subscription-payment-method.md): Point an individual subscription at a different saved card, so one site or service is billed separately from the rest of your workspace.
- [Canceling a hosting service](https://docs.cloudpress.com/guides/account/canceling-a-hosting-service.md): How canceling works for WordPress sites, Mailspace and cPanel hosting: you delete the service, it stays suspended for 7 days by default so you can bring it back, and the unused part of the term comes back as credit.
- [Inviting users and managing roles](https://docs.cloudpress.com/guides/account/inviting-users-and-roles.md): Invite people to a CloudPress workspace, pick the right role for each of them, and change roles, remove users, or manage pending invitations afterwards.
- [Setting up two-factor authentication](https://docs.cloudpress.com/guides/account/setting-up-two-factor-authentication.md): Protect your CloudPress login with a second factor: an authenticator app, a security key or a passkey, plus recovery codes for when you lose access.

### Advanced

- [Configuration file](https://docs.cloudpress.com/guides/advanced/configuration-file.md): Edit cloudpress.yml to change your site's public folder or to use Bedrock.
- [Custom server configuration](https://docs.cloudpress.com/guides/advanced/custom-server-config.md): Override a site's Nginx and PHP-FPM defaults by placing your own site.conf, nginx.conf, or pool.conf in your site's nginx folder — and revert safely if something breaks.
- [Purging the CDN from your site](https://docs.cloudpress.com/guides/advanced/purging-the-cdn-from-your-site.md): Ask CloudPress to purge a site's CDN cache from inside the site itself — from a script, a deploy hook, or an SSH or Cloud Shell session — for the whole site or for specific paths.
- [Roots Bedrock](https://docs.cloudpress.com/guides/advanced/bedrock.md): Install Roots Bedrock on a CloudPress site: what you give up compared with a standard install, and the install steps.

## Concepts

- [Concepts](https://docs.cloudpress.com/concepts/index.md): Background on how CloudPress works — the container platform behind your sites, backups, billing, the CDN and Shield edge, email, cPanel hosting, workspaces, resellers, and the developer tools.
- [The platform](https://docs.cloudpress.com/concepts/platform.md): How a CloudPress WordPress site is set up — your site, its database, an optional object cache, and file access — and why changing the PHP version briefly restarts your site.
- [How backups work](https://docs.cloudpress.com/concepts/backups.md): How CloudPress backs up a site — files and database backed up separately, the daily automatic schedule and its retention, and on-demand backups.
- [Billing](https://docs.cloudpress.com/concepts/billing.md): How CloudPress billing works — billing buckets and cycles, tiered volume discounts, and the credits issued when you downgrade or cancel.
- [CDN and Shield](https://docs.cloudpress.com/concepts/cdn-and-shield.md): What CloudPress's edge layer does: the CDN that caches and accelerates your site, and Shield's WAF, DDoS mitigation, bot detection, and rate limiting.
- [Email](https://docs.cloudpress.com/concepts/email.md): CloudPress has two email products: Mailspace for mailboxes people use, and Transactional Email for mail a WordPress site sends by itself. This page helps you pick the right one and fix DNS problems.
- [cPanel hosting](https://docs.cloudpress.com/concepts/cpanel-hosting.md): What a cPanel hosting account is on CloudPress, what CloudPress manages and what cPanel manages, and how it differs from a managed WordPress site.
- [Workspaces](https://docs.cloudpress.com/concepts/workspaces.md): How workspaces organize your sites, domains, billing, and people on CloudPress — finding and switching between them, the workspace page, roles, sub-workspaces, and leaving one.
- [Resellers](https://docs.cloudpress.com/concepts/resellers.md): How reselling works on CloudPress — white-label brands that rebrand the dashboard, sub-workspaces for each of your customers, and inherited billing that charges you instead of them.
- [Developer tools: API and MCP](https://docs.cloudpress.com/concepts/developer.md): How CloudPress's REST API and MCP server relate: what each does, how you authenticate, and when to call the API yourself versus letting an AI assistant do it.

## Developers

- [Overview](https://docs.cloudpress.com/developers/index.md): Build on CloudPress with the REST API or the MCP server — get an API key, learn the authentication options, and use OAuth 2.1 for third-party apps.

### Authentication

- [API overview](https://docs.cloudpress.com/api/overview.md): CloudPress REST API essentials: token authentication, account scoping, pagination and rate limits, error responses, and async operations with completion callbacks.
- [API keys](https://docs.cloudpress.com/api/api-keys.md): Create, list, rename, restrict by IP address, and delete the API keys that authenticate your CloudPress REST API requests — the key value is returned only once, when the key is created.
- [OAuth 2.1](https://docs.cloudpress.com/api/oauth.md): CloudPress's OAuth 2.1 authorization server for third-party apps — server metadata, the supported flows, dynamic client registration, and the scopes that gate each endpoint.

### API reference

- [Accounts](https://docs.cloudpress.com/api/accounts.md): Manage CloudPress accounts and their members over the API — list, create, update, move, and delete accounts, cancel a pending workspace move, and invite, view, change, and remove user roles.
- [Users](https://docs.cloudpress.com/api/users.md): Manage the users in your CloudPress account over the API — list, view, create, update, and delete users.
- [Subscriptions](https://docs.cloudpress.com/api/subscriptions.md): List and view the subscriptions on your CloudPress account — the recurring services behind your sites, domains, and add-ons — and see what will be added to the next invoice.
- [Orders](https://docs.cloudpress.com/api/orders.md): Place and manage orders over the API — list and view orders, order a new WordPress site, register or transfer a domain, and cancel an order.
- [Sites](https://docs.cloudpress.com/api/sites.md): Manage WordPress sites over the API — list, view, update and resize, restart, delete, single sign-on, backups and backup exports, metrics, and PHP version changes.
- [Site transactional email](https://docs.cloudpress.com/api/site-mail.md): Per-site transactional email endpoints — the delivery state of the mail a site sends itself, the sender identity, lifting a sending block, a DNS re-check, send logs and per-period usage.
- [Mailspace](https://docs.cloudpress.com/api/mailspace.md): Manage Mailspace mailbox hosting over the API — list and view mailspaces, purchase one for a domain, resize the package, and soft-delete.
- [Mailspace mailboxes](https://docs.cloudpress.com/api/mailspace-mailboxes.md): Manage the mailboxes inside a mailspace over the API — create, update, suspend, soft-delete and restore mailboxes, mint app passwords, write Sieve filter rules, and set out-of-office replies and forwarding.
- [Mailspace addresses](https://docs.cloudpress.com/api/mailspace-addresses.md): Manage addressing inside a mailspace over the API — aliases, distribution groups, mailing lists, and masked forwarding addresses.
- [Mailspace domains](https://docs.cloudpress.com/api/mailspace-domains.md): Manage the domains on a Mailspace over the API — add and remove secondary domains, prove ownership with a DNS TXT record, read the mail DNS records a domain needs, and re-check them.
- [Mailspace logs & recovery](https://docs.cloudpress.com/api/mailspace-logs.md): Read a mailspace's delivery logs over the API, browse, restore and download deleted mail from the archive, and recover a mailbox the mail server has not erased yet.
- [cPanel accounts](https://docs.cloudpress.com/api/cpanel-accounts.md): Manage cPanel hosting accounts over the API — list and view accounts, order a new one, change package, cancel and purge, change the password, manage domains, and open a cPanel session.
- [DNS](https://docs.cloudpress.com/api/dns.md): Manage authoritative DNS over the API — list, create, and delete DNS zones, toggle DNSSEC, view query statistics, and manage individual records.
- [Domains](https://docs.cloudpress.com/api/domains.md): Look up and manage domains over the API — list and search domains, check availability, attach a domain to a site, and pre-provision SSL certificates.
- [Domain registration](https://docs.cloudpress.com/api/domain-registration.md): Registrar endpoints for registering and transferring domains — registrant contacts, nameservers, transfer locks, WHOIS privacy, DNSSEC, hosts, and the async processes these operations open.
- [CDN, cache & logs](https://docs.cloudpress.com/api/cdn.md): Per-site CDN endpoints — CDN zone status, caching settings and purges, cache layers, edge rules, and CDN and origin access logs.
- [Shield (WAF, DDoS & bots)](https://docs.cloudpress.com/api/shield.md): Per-site Shield endpoints — activate a shield zone, configure the WAF and custom rules, bot detection, rate limits, and access lists, and read security events and metrics.
- [Tasks](https://docs.cloudpress.com/api/tasks.md): Track CloudPress's asynchronous operations over the API — list and view tasks, check their status, and use completion callbacks instead of polling.

### Integrations

- [Agent skill](https://docs.cloudpress.com/developers/agent-skill.md): Install the cloudpress-api agent skill so a coding agent writes correct CloudPress API calls — how it differs from the MCP server, and how to add it to Claude Code, Cursor, Codex and other agents.
- [MCP server](https://docs.cloudpress.com/developers/mcp.md): CloudPress's Model Context Protocol server — a stateless, OAuth-only JSON-RPC endpoint that exposes sites, DNS, domains, CDN, and Shield to AI assistants as MCP tools.
- [Billing webhooks](https://docs.cloudpress.com/developers/billing-webhooks.md): Outbound notifications CloudPress sends to an external billing system when a site, cPanel account, or domain registration changes — configuration, delivery semantics, the events, and each payload.
- [Callbacks](https://docs.cloudpress.com/api/callbacks.md): Attach a callback URL to an order so CloudPress notifies you when its async work finishes instead of polling — registering one, the payload it sends, delivery and retries, and how callbacks differ from billing webhooks.