mash-playbook/docs/services/wordpress.md
Julian-Samuel Gebühr 38e2f01b68
Add Wordpress (#220)
* feat: Add wordpress basics

* docs(wordpres): Add draft

* fix(wordpress): Database hostname

* feat: Add wordpress basics

* docs(wordpress): Expand stub to full docu

* chore(wordpress): Update role

* fix: readd group vars

* feat(wordpress): Add basic auth option

* Minor adjustments to WordPress documentation

* feat: Set default for db

Co-authored-by: Slavi Pantaleev <slavi@devture.com>

* feat(wordpress): Add defaults as suggested

Co-authored-by: Slavi Pantaleev <slavi@devture.com>

* feat(wordpress): Use defaults as suggested

Co-authored-by: Slavi Pantaleev <slavi@devture.com>

* feat(wordpress): Add defaults as suggested

Co-authored-by: Slavi Pantaleev <slavi@devture.com>

* docs(wordpress): Remove redundant MariaDB mention

---------

Co-authored-by: Slavi Pantaleev <slavi@devture.com>
2024-07-03 14:22:49 +03:00

52 lines
1.9 KiB
Markdown

# Wordpress
[WordPress](https://wordpress.org/) is a widley used open source web content management system that this playbook can install, powered by the [mother-of-all-self-hosting/ansible-role-wordpress](https://github.com/mother-of-all-self-hosting/ansible-role-wordpress) Ansible role.
## Dependencies
This service requires the following other services:
- a [MariaDB](mariadb.md) database
- a [Traefik](traefik.md) reverse-proxy server
## Configuration
```yaml
########################################################################
# #
# wordpress #
# #
########################################################################
wordpress_enabled: true
wordpress_hostname: example.org
########################################################################
# #
# /wordpress #
# #
########################################################################
```
## Usage
Navigate to the domain you set as `wordpress_hostname`, select a language and create an admin user.
> **Make sure to create a user with a strong password**
You can now log in and fill your website with content!
## Advanced
### Basic authentication
If you don't want to have your website accessible to everyone (e.g. you first want to present it to a client) you can use
```yaml
wordpress_container_labels_middleware_basic_auth_enabled: true
# Use `htpasswd -nb USERNAME PASSSWORD` to generate the users below.
# See: https://doc.traefik.io/traefik/middlewares/http/basicauth/#users
wordpress_container_labels_middleware_basic_auth_users: ''
```