Skip to content

Commit

Permalink
Merge pull request #40 from WordOps/release-v3-21-0
Browse files Browse the repository at this point in the history
Prepare for release v3.21.0
  • Loading branch information
VirtuBox authored Jun 10, 2024
2 parents 14dbf67 + 9e721e3 commit 9d3af4e
Show file tree
Hide file tree
Showing 10 changed files with 174 additions and 134 deletions.
4 changes: 2 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,8 +42,8 @@

- **Easy to install** : One step automated installer with migration from EasyEngine v3 support
- **Fast deployment** : Fast and automated WordPress, Nginx, PHP, MySQL & Redis installation
- **Custom Nginx build** : Nginx 1.24.0 - TLS v1.3 Cloudflare HTTP/2 HPACK & Brotli support
- **Up-to-date** : PHP 7.2, 7.3, 7.4, 8.0, 8.1 & 8.2 - MariaDB 10.11 & Redis 7.0
- **Custom Nginx build** : Nginx 1.26.1 - TLS v1.3 with HTTP/3 QUIC & Brotli support
- **Up-to-date** : PHP 7.4, 8.0, 8.1, 8.2 & 8.3 - MariaDB 11.4 & Redis 7.0
- **Secured** : Hardened WordPress security with strict Nginx location directives
- **Powerful** : Optimized Nginx configurations with multiple cache backends support
- **SSL** : Domain, Subdomain & Wildcard Let's Encrypt SSL certificates with DNS API support
Expand Down
19 changes: 10 additions & 9 deletions docs/commands/info.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,13 @@ wo info [options]

Without any option, `wo info` will display all informations.

optional arguments | description
-------------------- | -------------------------------------
`--nginx` | Get Nginx configuration information |
`--php` | Get PHP 7.2 configuration information |
`--php73` | Get PHP 7.3 configuration information |
`--php74` | Get PHP 7.4 configuration information |
`--php80` | Get PHP 8.0 configuration information |
`--php81` | Get PHP 8.1 configuration information |
`--mysql` | Get MySQL configuration information |
| optional arguments | description |
| ------------------ | ---------------------------------------------- |
| `--nginx` | Get Nginx configuration information |
| `--php` | Get All PHP versions configuration information |
| `--php74` | Get PHP 7.4 configuration information |
| `--php80` | Get PHP 8.0 configuration information |
| `--php81` | Get PHP 8.1 configuration information |
| `--php82` | Get PHP 8.2 configuration information |
| `--php83` | Get PHP 8.3 configuration information |
| `--mysql` | Get MySQL configuration information |
4 changes: 4 additions & 0 deletions docs/commands/secure.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,8 +66,12 @@ You can also edit directly the file `/etc/nginx/common/acl.conf`
## Harden SSH security

!!! warning

<!-- prettier-ignore -->
To harden SSH security, WordOps render the configuration sshd_config from a template. In this template, root authentification with password is forbidden and by default password authentification is disabled. You can use the flag `--allowpassword` with `--ssh` to allow password authentification, but before running this command please make sure you will not be locked out of your server. Using password-less authentification with SSH keys is highly recommended.

<!-- prettier-ignore-end -->

To harden SSH security you can use the command :

```bash
Expand Down
74 changes: 37 additions & 37 deletions docs/commands/site.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ wo site (command) [options]
```

| subcommand | description |
|--------------------------|-----------------------------------|
| ------------------------ | --------------------------------- |
| [create](#site-create) | Create site with WordOps |
| [update](#site-update) | Update site type or configuration |
| [info](#site-info) | Get site information |
Expand Down Expand Up @@ -79,7 +79,6 @@ wo site create site.tld --alias sitetoredirect.tld

It will create a nginx vhost for site.tld which redirect to sitetoredirect.tld.


### WordPress

Following are the WordPress website types you can create website based on Cache Mechanism
Expand Down Expand Up @@ -128,14 +127,14 @@ wo site create site.tld --ngxblocker

#### Cheatsheet

| Cache | single site | multisite w/ subdir | multisite w/ subdom |
| ------------------------- | ------------- | ----------------------- | -------------------------- |
| **NO Cache** | `--wp` | `--wpsubdir` | `--wpsubdomain` |
| **WP Super Cache plugin** | `--wpsc` | `--wpsubdir --wpsc` | `--wpsubdomain --wpsc` |
| **Nginx fastcgi_cache** | `--wpfc` | `--wpsubdir --wpfc` | `--wpsubdomain --wpfc` |
| **Redis cache** | `--wpredis` | `--wpsubdir --wpredis` | `--wpsubdomain --wpredis` |
| **WP-Rocket plugin** | `--wprocket` | `--wpsubdir --wprocket` | `--wpsubdomain --wprocket` |
| **Cache-Enabler plugin** | `--wpce` | `--wpsubdir --wpce` | `--wpsubdomain --wpce` |
| Cache | single site | multisite w/ subdir | multisite w/ subdom |
| ------------------------- | ------------ | ----------------------- | -------------------------- |
| **NO Cache** | `--wp` | `--wpsubdir` | `--wpsubdomain` |
| **WP Super Cache plugin** | `--wpsc` | `--wpsubdir --wpsc` | `--wpsubdomain --wpsc` |
| **Nginx fastcgi_cache** | `--wpfc` | `--wpsubdir --wpfc` | `--wpsubdomain --wpfc` |
| **Redis cache** | `--wpredis` | `--wpsubdir --wpredis` | `--wpsubdomain --wpredis` |
| **WP-Rocket plugin** | `--wprocket` | `--wpsubdir --wprocket` | `--wpsubdomain --wprocket` |
| **Cache-Enabler plugin** | `--wpce` | `--wpsubdir --wpce` | `--wpsubdomain --wpce` |

#### Extra settings

Expand Down Expand Up @@ -221,15 +220,19 @@ export CF_Email="[email protected]"
```

!!! info

<!-- prettier-ignore -->
More example in our guide about [DNS API configuration](/how-to/configure-letsencrypt-dns-api-validation)

<!-- prettier-ignore-end -->

After you define those variables with the command `export`, you can issue your certificate with

```bash
wo site create site.tld --wp --letsencrypt=wildcard --dns=dns_cf
```

* `--dns=dns_cf` can be replaced with another DNS provider supported by acme.sh. For DigitalOcean, it would be `--dns=dns_dgon`
- `--dns=dns_cf` can be replaced with another DNS provider supported by acme.sh. For DigitalOcean, it would be `--dns=dns_dgon`

#### HSTS

Expand All @@ -239,32 +242,32 @@ Additionally you can enable HSTS on your site by adding the flag `--hsts` with `
wo site create site.tld --wp --letsencrypt --hsts
```

#### PHP 7.3 & PHP 7.4
#### PHP 8.2 & PHP 8.2

To create site with PHP 7.3 you can use --php73 during site creation
To create site with PHP 8.2 you can use --php82 during site creation

For example, you can create WordPress site running on PHP 7.3 using following command:
For example, you can create WordPress site running on PHP 8.2 using following command:

```bash
wo site create site.tld --wp --php73
wo site create site.tld --wp --php82
```

For a WordPress site running on PHP 7.4:
For a WordPress site running on PHP 8.3:

```bash
wo site create site.tld --wp --php74
wo site create site.tld --wp --php83
```

To create simple php site running with PHP 7.3 with no database, you can use this command:
To create simple php site running with PHP 8.3 with no database, you can use this command:

```bash
wo site create site.tld --php73
wo site create site.tld --php83
```

This is the same with PHP 7.4:
This is the same with PHP 8.2:

```bash
wo site create site.tld --php74
wo site create site.tld --php82
```

## site update
Expand All @@ -277,11 +280,11 @@ Update site configuration

Before Updating any site:

* Creates nginx configuration backup for site.
* Moves htdocs to backup while updating HTML/PHP/MySQL site.
* Creates database dump in backup.
* While updating current MySQL site WordOps uses same database for installing WordPress tables.
* All these backup are stored outside htdocs, in backup directory.
- Creates nginx configuration backup for site.
- Moves htdocs to backup while updating HTML/PHP/MySQL site.
- Creates database dump in backup.
- While updating current MySQL site WordOps uses same database for installing WordPress tables.
- All these backup are stored outside htdocs, in backup directory.

### WordOps possible Update Options

Expand Down Expand Up @@ -325,8 +328,6 @@ Before Updating any site:
};
posObjs();</script>



Example: updating site from basic wp to wp + fastcgi_cache:

<asciinema-player src="/images/wositeupdate.cast" autoplay loop cols="120" rows="30"></asciinema-player>
Expand All @@ -344,12 +345,11 @@ wo site update [<site_name>] [options]
| `--html` | update to html site |
| `--php` | update to php site |
| `--mysql` | update to MySQL + PHP site |
| `--php72` | update site to PHP 7.2 |
| `--php73` | update site to PHP 7.3 |
| `--php74` | update site to PHP 7.4 |
| `--php80` | update site to PHP 8.0 |
| `--php81` | update site to PHP 8.1 |
| `--php82` | update site to PHP 8.2 |
| `--php82` | update site to PHP 8.3 |
| `--wp` | update site to WordPress without cache |
| `--wpfc` | update site to WordPress with fastcgi_cache |
| `--wpsc` | update site to WordPress with wp-super-cache plugin |
Expand All @@ -374,22 +374,22 @@ Update a WordPress site without cache (`--wp`), to WordPress with Nginx fastcgi_
wo site update site.tld --wpfc
```

Update a WordPress site running with PHP 7.2 to PHP 7.3
Update a WordPress site running with PHP 8.2 to PHP 8.3

```bash
wo site update site.tld --php73
wo site update site.tld --php83
```

Update a site running with PHP 7.3 to PHP 7.2
Update a site running with PHP 8.3 to PHP 8.1

```bash
wo site update site.tld --php72
wo site update site.tld --php81
```

Update a site running with PHP 7.2 or PHP 7.3 to PHP 7.4
Update a site running with PHP 8.1 or PHP 8.2 to PHP 8.3

```bash
wo site update site.tld --php74
wo site update site.tld --php83
```

Update a WordPress site with Nginx fastcgi_cache to WordPress with redis-cache
Expand Down Expand Up @@ -421,7 +421,7 @@ wo site delete [<site_name>] [options]
```

| options | description |
|---------------|--------------------------------------------|
| ------------- | ------------------------------------------ |
| `--no-prompt` | delete website without confirmation prompt |
| `--files` | delete only website files |
| `--db` | delete only database |
Expand Down
Loading

0 comments on commit 9d3af4e

Please sign in to comment.