PHP application stack for Kubernetes on Wodby

Deploy PHP applications on Kubernetes with Wodby.

This repository defines the Wodby stack manifests and default service composition for PHP.

Stack contract

• PHP stack on Wodby
• Browse Wodby application stacks
• Wodby stack documentation
• Stack manifest reference

Start from a boilerplate

Use one of the compatible boilerplates exposed by this stack's services to start with Wodby CI build configuration:

• Composer boilerplate

Service definitions

• PHP service
• Nginx (PHP) service
• MariaDB service
• Apache HTTP server (PHP) service
• PostgreSQL service
• Valkey service
• Mailpit service
• OpenSMTPD service
• Gotenberg service

What's included

Component / service	Default configuration
PHP php	required; enabled by default; links: db → mariadb, sendmail → mailpit
Nginx nginx	required; enabled by default; links: backend → php
MariaDB mariadb	optional; enabled by default; volumes: data 20 GB
Apache HTTP server httpd	optional; disabled by default; links: backend → php
PostgreSQL postgres	optional; disabled by default; volumes: data 20 GB
Valkey valkey	optional; disabled by default
Mailpit mailpit	optional; enabled by default
OpenSMTPD opensmtpd	optional; disabled by default
Gotenger gotenberg	optional; disabled by default

Enabled optional services are selected by default but can be excluded when an app is created. Disabled optional services are available but not selected by default. Required services cannot be excluded.

Validate the stack manifest

wodby stack validate-manifest stack.yml --org <org-id>

Deploy this stack

Start from Composer boilerplate, or connect your own compatible source repository.

Review service versions, storage, links, and optional components when creating the application. The same stack can be reused across development, staging, and production environments.

Maintain a custom version

1. Fork this repository.
2. Edit the stack manifest.
3. Import the repository as a Git-backed stack.

When replacing or renaming a stack service, update every related link target and derivative reference. Stack-local names and referenced service names are distinct identifiers.