Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bfren/docker-wordpress
Docker WordPress image.
https://github.com/bfren/docker-wordpress
docker docker-wordpress nginx php wordpress
Last synced: 23 days ago
JSON representation
Docker WordPress image.
- Host: GitHub
- URL: https://github.com/bfren/docker-wordpress
- Owner: bfren
- License: mit
- Created: 2020-11-08T10:40:06.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-19T12:40:21.000Z (6 months ago)
- Last Synced: 2024-05-19T13:44:50.101Z (6 months ago)
- Topics: docker, docker-wordpress, nginx, php, wordpress
- Language: Nushell
- Homepage:
- Size: 442 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Docker WordPress
   
[Docker Repository](https://hub.docker.com/r/bfren/wordpress) - [bfren ecosystem](https://github.com/bfren/docker)
Comes with [WordPress](https://en-gb.wordpress.org) en_GB preinstalled - if you want a different locale, use the Dockerfiles and set the `WP_LOCALE` argument. [Ninja Firewall](https://wordpress.org/plugins/ninjafirewall/) is preinstalled and setup to work in [Full WAF mode](https://blog.nintechnet.com/full_waf-vs-wordpress_waf/). [WP-WebAuthn](https://wordpress.org/plugins/wp-webauthn/) is also preinstalled to provide support for passkey authentication.
The required and recommended PHP modules are all installed.
## Contents
* [Ports](#ports)
* [Volumes](#volumes)
* [Environment Variables](#environment-variables)
* [Helper Functions](#helper-functions)
* [Nginx Configuration Helpers](#nginx-configuration-helpers)
* [Licence / Copyright](#licence)
## Ports
* 80
## Volumes
| Volume | Purpose |
| ----------------- | ---------------------------------------------------- |
| `/wp-content` | `wp-content` directories and `wp-config.php` file. |
See the [Nginx](https://github.com/bfren/docker-nginx) image for other configuration details.
## Environment Variables
See the [Nginx + PHP](https://github.com/bfren/docker-nginx-php) image for details of `www.conf` and `php.ini` overrides using environment variables.
| Variable | Values | Description | Default |
| --------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------- |
| `BF_WP_CLEAN_INSTALL` | 0 or 1 | Set to 1 to wipe WordPress files and start again (WARNING: YOU WILL LOSE EVERYTHING!). | 0 |
| `BF_WP_CONFIG_ADDITIONAL` | string | Additional configuration settings to add to the end of `wp-config.php` - use in conjunction with WP_CONFIG_GENERATE=harden. | *None* |
| `BF_WP_CONFIG_HARDEN` | 0 or 1 | Default value 1 makes `wp-config.php` readonly. Value 0 makes it writeable - helpful for plugins that need to write values to it. | 1 |
| `BF_WP_CONFIG_REGENERATE` | 0 or 1 | Default value 1 generates `wp-config.php` each time and makes readonly. Value 0 generates if it does not exist but then leaves it alone. | harden |
| `BF_WP_DB_NAME` | string | Database name. | *None* - required if `BF_WP_CONFIG_REGENERATE` is '1' |
| `BF_WP_DB_USER` | string | Database username. | *None* - required if `BF_WP_CONFIG_REGENERATE` is '1' |
| `BF_WP_DB_PASS` | string | Database password. | *None* - required if `BF_WP_CONFIG_REGENERATE` is '1' |
| `BF_WP_DB_HOST` | string | Database host. | *None* - required if `BF_WP_CONFIG_REGENERATE` is '1' |
| `BF_WP_DB_CHARSET` | string | Database character set (leave as default if not sure). | utf8mb4 |
| `BF_WP_DB_COLLATE` | string | Database collation (leave blank if not sure). | *None* |
| `BF_WP_DB_PREFIX` | string | Database table prefix - an underscore will be added automatically. | wp |
| `BF_WP_DEBUG` | true or false | Whether or not to enable debug mode. | false |
| `BF_WP_DISABLE_MAJOR_UPDATES` | 0 or 1 | Set to 0 to enable WordPress core major system updates (otherwise they are handled by the image). | 1 |
| `BF_WP_ENABLE_HTTPS_BEHIND_PROXY` | 0 or 1 | Whether or not to enable HTTPS behind a proxy server. | 1 |
| `BF_WP_INSTALL_NINJAFIREWALL` | 0 or 1 | Whether or not to install the NinjaFirewall plugin. | 1 |
| `BF_WP_INSTALL_WEBAUTHN` | 0 or 1 | Whether or not to install the WebAuthn plugin. | 1 |
| `BF_WP_REDIS_HOST` | string | Set to enable redis on the specified host. | *None* |
| `BF_WP_REDIS_PORT` | integer | Set to override the default redis port (6379). | *None* |
| `BF_WP_USE_SYSTEM_CRON` | 0 or 1 | Set to 0 to use WordPress cron instead of system cron (reduces page performance). | 1 |
## Helper Functions
| Function | Purpose | Usage |
| --------------------- | ---------------------------------------------------------------------------------------------- | --------------------- |
| `wp-cron` | Runs the WordPress cron - if `WP_USE_SYSTEM_CRON` is 1, will be run automatically. | `wp-cron` |
## Nginx Configuration Helpers
The image contains a handful of useful Nginx configuration 'helper' files, which you can find in `/overlay/etc/nginx/helpers`. They all begin with the prefix 'wp':
| Helper | Description |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `-restrictions.conf` | Adds various security-based restrictions. |
| `-subdirectory.conf` | Enables WordPress to run in a `wordpress` subdirectory - copy and replace with the name your own subdirectory to use. |
## Licence
> [MIT](https://mit.bfren.dev/2020)
## Copyright
> Copyright (c) 2020-2024 [bfren](https://bfren.dev) (unless otherwise stated)