wordpress/README.md

# Wordpress

[![Build Status](https://drone.autonomic.zone/api/badges/coop-cloud/wordpress/status.svg)](https://drone.autonomic.zone/coop-cloud/wordpress)

Coöp Cloud + [Wordpress](https://wordpress.org) = 🥳

<!-- metadata -->

* **Category**: Apps
* **Status**: 3, stable
* **Image**: [`wordpress`](https://hub.docker.com/_/wordpress), 4, upstream
* **Healthcheck**: Yes
* **Backups**: Yes
* **Email**: 3
* **Tests**: 2
* **SSO**: No

<!-- endmetadata -->

## Basic usage

1. Set up Docker Swarm and [`abra`][abra]
2. Deploy [`coop-cloud/traefik`][cc-traefik]
3. `abra app new wordpress --secrets` (optionally with `--pass` if you'd like
   to save secrets in `pass`)
4. `abra app YOURAPPDOMAIN config` - be sure to change `$DOMAIN` to something that resolves to
   your Docker swarm box
5. `abra app YOURAPPDOMAIN deploy`
6. Open the configured domain in your browser to finish set-up
7. `abra app YOURAPPDOMAIN run app chown www-data:www-data /var/www/html/wp-content` to fix
   file permissions (see #3)

## Running WP-CLI

`abra app cmd YOURAPPDOMAIN app wp -- core check-update --major`

## Network (Multi-site)

_(Only tested using subdomains)_

1. Set up as above
2. `abra app YOURAPPDOMAIN config`, and uncomment the first `# Multisite` section
3. `abra app YOURAPPDOMAIN deploy`
4. Log into the Wordpress admin dashboard, go to Tools » Network Setup
5. Don't worry about the suggested file changes
6. `abra app YOURAPPDOMAIN config` again - comment out the first `# Multisite`
   section in `.envrc`, uncomment the `# Multisite phase 2` section, and add
   your multisite subdomain(s) to `EXTRA_DOMAINS` (beware the weird syntax..)
7. `abra app YOURAPPDOMAIN deploy`

## Installing a custom theme

`abra app YOURAPPDOMAIN cp ~/path/to/local/theme wordpress:/var/www/html/wp-content/themes/`

## Email

There is a local or remote SMTP relay configuration available.

* **local**: `COMPOSE_FILE=compose.yml:compose.mailrelay.yml`
* **remote**: `COMPOSE_FILE=compose.yml:compose.mailrelay.yml:compose.smtp.yml`

Below are the instructions for the local relay.

1. Deploy [`postfix-relay`][cc-postfix-relay]
2. `abra app YOURAPPDOMAIN config`, and uncomment the email lines; change
   `MAIL_FROM` to make sure the domain is the same as `postfix-relay`'s
   `$DOMAIN` or in its `$EXTRA_SENDER_DOMAINS`
3. `abra app YOURAPPDOMAIN deploy`

[abra]: https://git.autonomic.zone/autonomic-cooperative/abra
[cc-traefik]: https://git.autonomic.zone/coop-cloud/traefik
[cc-postfix-relay]: https://git.autonomic.zone/coop-cloud/traefik
Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:45 +00:00			`# Wordpress`
Init this new WP setup 2020-05-02 22:21:33 +00:00
Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			`[![Build Status](https://drone.autonomic.zone/api/badges/coop-cloud/wordpress/status.svg)](https://drone.autonomic.zone/coop-cloud/wordpress)`
Add build status to README [ci skip] 2020-09-25 13:06:35 +00:00
Update for Current Exciting Sep 2020 Best-Practice 2020-09-10 23:30:10 +00:00			`Coöp Cloud + [Wordpress](https://wordpress.org) = 🥳`

Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:45 +00:00			`<!-- metadata -->`
Formatting and remove backup bot docs 2021-05-10 05:09:52 +00:00
chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:04 +00:00			`* Category: Apps`
Goodbye, emojis! 😢 [ci skip] 2021-11-23 10:19:06 +00:00			`* Status: 3, stable`
			* Image: [`wordpress`](https://hub.docker.com/_/wordpress), 4, upstream
chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:04 +00:00			`* Healthcheck: Yes`
			`* Backups: Yes`
Goodbye, emojis! 😢 [ci skip] 2021-11-23 10:19:06 +00:00			`* Email: 3`
			`* Tests: 2`
chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:04 +00:00			`* SSO: No`
Fix README formatting 2021-05-30 10:58:17 +00:00
Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:45 +00:00			`<!-- endmetadata -->`

			`## Basic usage`

Update for Current Exciting Sep 2020 Best-Practice 2020-09-10 23:30:10 +00:00			1. Set up Docker Swarm and [`abra`][abra]
Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			2. Deploy [`coop-cloud/traefik`][cc-traefik]
Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:45 +00:00			3. `abra app new wordpress --secrets` (optionally with `--pass` if you'd like
			to save secrets in `pass`)
Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			4. `abra app YOURAPPDOMAIN config` - be sure to change `$DOMAIN` to something that resolves to
Update for Current Exciting Sep 2020 Best-Practice 2020-09-10 23:30:10 +00:00			`your Docker swarm box`
Formatting and remove backup bot docs 2021-05-10 05:09:52 +00:00			5. `abra app YOURAPPDOMAIN deploy`
			`6. Open the configured domain in your browser to finish set-up`
			7. `abra app YOURAPPDOMAIN run app chown www-data:www-data /var/www/html/wp-content` to fix
Add note about permissions 2020-09-17 21:45:01 +00:00			`file permissions (see #3)`
Update for Current Exciting Sep 2020 Best-Practice 2020-09-10 23:30:10 +00:00
Add custom abra command to run WP-CLI Closes #2 2020-12-14 10:31:17 +00:00			`## Running WP-CLI`

feat: yet another attempt at wp-cli 2022-03-30 23:24:33 +00:00			`abra app cmd YOURAPPDOMAIN app wp -- core check-update --major`
Add custom abra command to run WP-CLI Closes #2 2020-12-14 10:31:17 +00:00
Initial network / multisite support 2020-09-14 16:45:17 +00:00			`## Network (Multi-site)`

			`_(Only tested using subdomains)_`

			`1. Set up as above`
Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			2. `abra app YOURAPPDOMAIN config`, and uncomment the first `# Multisite` section
			3. `abra app YOURAPPDOMAIN deploy`
			`4. Log into the Wordpress admin dashboard, go to Tools » Network Setup`
			`5. Don't worry about the suggested file changes`
			6. `abra app YOURAPPDOMAIN config` again - comment out the first `# Multisite`
			section in `.envrc`, uncomment the `# Multisite phase 2` section, and add
			your multisite subdomain(s) to `EXTRA_DOMAINS` (beware the weird syntax..)
			7. `abra app YOURAPPDOMAIN deploy`
Initial network / multisite support 2020-09-14 16:45:17 +00:00
Document how to install a custom theme 2020-09-14 17:28:31 +00:00			`## Installing a custom theme`

Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			`abra app YOURAPPDOMAIN cp ~/path/to/local/theme wordpress:/var/www/html/wp-content/themes/`
Document how to install a custom theme 2020-09-14 17:28:31 +00:00
Improve email set-up 2020-09-27 19:27:08 +00:00			`## Email`

Add some docs 2021-06-02 09:26:03 +00:00			`There is a local or remote SMTP relay configuration available.`

chore: fix README bullet formatting [ci skip] 2021-11-22 11:42:04 +00:00			* local: `COMPOSE_FILE=compose.yml:compose.mailrelay.yml`
			* remote: `COMPOSE_FILE=compose.yml:compose.mailrelay.yml:compose.smtp.yml`
Add some docs 2021-06-02 09:26:03 +00:00
			`Below are the instructions for the local relay.`

Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			1. Deploy [`postfix-relay`][cc-postfix-relay]
			2. `abra app YOURAPPDOMAIN config`, and uncomment the email lines; change
			`MAIL_FROM` to make sure the domain is the same as `postfix-relay`'s
			`$DOMAIN` or in its `$EXTRA_SENDER_DOMAINS`
			3. `abra app YOURAPPDOMAIN deploy`
Improve email set-up 2020-09-27 19:27:08 +00:00
Use latest stack-ssh-deploy, change SSH key name 2020-09-25 12:24:38 +00:00			`[abra]: https://git.autonomic.zone/autonomic-cooperative/abra`
Update README for new `abra` UI 2020-12-14 10:28:46 +00:00			`[cc-traefik]: https://git.autonomic.zone/coop-cloud/traefik`
Follow new exciting README standard See coop-cloud/organising#31 2021-03-02 16:38:45 +00:00			`[cc-postfix-relay]: https://git.autonomic.zone/coop-cloud/traefik`