[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

wordpress-nix

A fast FrankenPHP WordPress stack built with Nix, deployable as OCI containers or a NixOS module, with MySQL, Cloudflare D1, or Turso databases.

[Open source](/open-source/)

wordpress-nix

NixOSActiveMIT

[View on GitHub (opens in a new tab)](https://github.com/Avunu/wordpress-nix)[Documentation (opens in a new tab)](https://docs.avunu.net/wordpress-nix/)

PlatformNixOS

LicenseMIT

StatusActive

Repository[Avunu/wordpress-nix](https://github.com/Avunu/wordpress-nix)

Part ofThe Nix platform

Used in

Most WordPress hosting is a pile of hand-tuned servers. wordpress-nix replaces that with a single, shared Nix codebase that builds an optimized PHP and FrankenPHP stack and deploys it either as containers or directly on NixOS. Sites can be managed through the WordPress admin as usual, or pinned to a git repository for fully source-controlled deploys. It's for agencies and site owners who want fast, reproducible WordPress hosting they control.

## Features

**Optimized runtime.** PHP 8.2, 8.3, or 8.4 per site, served by FrankenPHP, with CPU-specific build flags. On NixOS, Caddy handles TLS certificates automatically.

**Two site modes.** "State" keeps WordPress core mutable for admins who manage plugins in the UI; "git" mounts a read-only document root from a flake input, with uploads kept writable.

**Database choices.** MariaDB or MySQL, local or external, or serverless SQLite through Cloudflare D1 or Turso.

**Platform hardening.** Built-in mu-plugins for edge cache signals, performance indexes, and user-enumeration protection, so sites don't need extra plugins.

**Bootstrapping.**`nix run github:Avunu/wordpress-nix` scaffolds a new site, adopts an existing install without moving anything, or reconciles a site that's already set up.

**Containers** built and pushed to a registry by CI.

## Getting started

You need Nix with flakes. Run the bootstrapper in your site's directory, then follow the [README](https://github.com/Avunu/wordpress-nix#bootstrapping-a-site) to bring up the local stack:

```
<span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">cd</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">~/sites/example</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> && </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">nix</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">run</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">github:Avunu/wordpress-nix</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">    </span><span style="--shiki-dark:#8B949E;--shiki-light:#6E7781"># or pass a directory</span>
```

Highlights

Optimized PHP 8.2 to 8.4 builds on FrankenPHPNixOS module with mutable or git-managed sitesMySQL, Cloudflare D1, or Turso database backendsPlatform mu-plugins for caching signals and user-enumeration hardeningBootstrapper that adopts an existing WordPress install in place

Related projects

[All open-source projects](/open-source/)

[frappe-nix](/open-source/frappe-nix/)

Active

Reproducible Nix infrastructure for Frappe and ERPNext, from the development shell to OCI containers and a multi-site NixOS module.

MIT[GitHub](https://github.com/Avunu/frappe-nix)

[odoo-nix](/open-source/odoo-nix/)

Active

Reproducible Nix infrastructure for Odoo Community (OCB) and OCA, from scaffolding projects and addon repositories to repository standards, CI, containers, and NixOS.

MIT[GitHub](https://github.com/Avunu/odoo-nix)

[Web Kiosk](/open-source/web_kiosk/)

Stable

A USB-booting NixOS image that turns an x86 computer into a locked-down Firefox kiosk for a single web page.

MIT[GitHub](https://github.com/Avunu/web_kiosk)

Need help with it?

Need this implemented? We host WordPress on this platform as part of our Websites and managed infrastructure services.

[Explore Websites](/services/websites/)[Start a project](/start/)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
