> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackshift.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy WordPress on StackShift

> Launch single-site WordPress as a template-backed stack with bundled MariaDB and persistent storage.

<Tip>
  **Live.** This area is documented as current, user-reliable behavior.
</Tip>

## Goal

Deploy WordPress with the right first-boot and persistence expectations.

## Prerequisites

* A healthy node
* A published WordPress template

## Workflow

<Steps>
  <Step>
    Open the WordPress template detail page and review its readiness notes.
  </Step>

  <Step>
    Choose the site title, admin credentials, and bundled database credentials.
  </Step>

  <Step>
    Deploy on either a generated StackShift hostname or the final custom domain, then redeploy later if the hostname changes.
  </Step>
</Steps>

## What you get

* WordPress provisioned as a managed runtime-native stack, not hand-rolled containers.
* A bundled MariaDB database for the site, managed as part of the runtime.
* Persistent named volumes for WordPress files and the database — these are what backups capture.

## First boot and credentials

At deploy you set the site title, the admin username and password, and the bundled database credentials. WordPress runs its first-boot setup against those values, so choose them deliberately rather than relying on placeholders.

## Hostname now, custom domain later

You can launch on a generated StackShift hostname and attach the final custom domain afterwards. WordPress stores its site URL internally, so if you change the hostname later you resync the URLs (redeploy or the update site URL action) to avoid redirect loops and broken assets.

## Expected result

<Check>
  A template-backed WordPress stack is running with persistent WordPress and database volumes.
</Check>

## Related guides

<CardGroup cols={2}>
  <Card title="Connect a custom domain to WordPress" href="/wordpress/connect-a-custom-domain-to-wordpress">
    Understand how StackShift routing and WordPress site URLs interact before and after first boot.
  </Card>

  <Card title="Back up and restore a WordPress stack" href="/wordpress/back-up-and-restore-a-wordpress-stack">
    Use StackShift stack backups for WordPress content and bundled MariaDB data, then validate the app after restore.
  </Card>
</CardGroup>