jhammah/wordpress
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Josh
2025-06-26 14:29:06 +00:00
parent a7523d6e56
commit 307741aad8
1 changed files with 171 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files

204
README.md
View File

@@ -29,7 +29,7 @@
<br> <br>
<h1 align="center">How to efficiently install, host, and maintain lightning fast Wordpress websites inside Docker Desktop on Windows 11 </h1> <h1 align="center">How to efficiently install, host, and maintain lightning fast Wordpress websites inside Docker Desktop on Windows 11</h1>
<br> <br>
@@ -46,6 +46,8 @@
- [Reverse Proxy Steps](#reverse-proxy-steps) - [Reverse Proxy Steps](#reverse-proxy-steps)
- [wp-config.php configuration](#wp-configphp-configuration) - [wp-config.php configuration](#wp-configphp-configuration)
- [Caddyfile Configuration](#caddyfile-configuration) - [Caddyfile Configuration](#caddyfile-configuration)
- [Redis Plugin](#redis-plugin)
- [Final Test](#final-test)
<br> <br>
@@ -53,7 +55,7 @@
# Prerequisite # Prerequisite
- **If you are using Cloudflare to host your domain, you NEED to make sure that it's SSL/TLS encryption mode is set to 'Full (strict)'. By default, domains are set to 'Flexible' and you'll get thrown in an infinite loop when you try and go to your website while using a reverse proxy.** - **If you are using Cloudflare to host your domain, you NEED to make sure that it's SSL/TLS encryption mode is set to 'Full (strict)'. By default, domains are set to 'Flexible' and you'll get thrown in an infinite loop when you try and go to your website while using a reverse proxy**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
@@ -63,15 +65,17 @@
</a> </a>
</p> </p>
- **For these instructions we'll be using the example domain called 'website.com' and will be changing names and code to match it accordingly, like this 'wp-website-com'.** - **For these instructions we'll be using the example domain called 'website.com' and will be changing names and code to match it accordingly, like this 'wp-website-com'**
- **For very nice organization, I recommend keeping the ' wp- ' part at the beginning of the naming scheme so you can easily filter out containers and find what you're looking for very quickly and neatly.** - **For very nice organization, I recommend keeping the ' wp- ' part at the beginning of the naming scheme so you can easily filter out containers and find what you're looking for very quickly and neatly**
- **The password to extract all of the tutorial files from the zip file is: JHammaH** - **The password to extract all of the tutorial files from the zip file is: JHammaH**
- **Create a folder called ' wordpress ' in an easy to find directory like: '** c:/docker/**wordpress '** - **Create a folder called ' wordpress ' in an easy to find directory like: '** c:/docker/**wordpress '**
- **Extract the contents of the downloaded zip file to inside the new ' wordpress ' folder. You will see three files. A .bat file, a dockerfile, and a folder called ' wp-new-site '** - **Extract the zip file called ' extract-this-in-your-wordpress-folder.zip ' to inside the new ' wordpress ' folder. You will see a .bat file and a folder called ' wp-new-site '**
- **Inside the ' nwp-new-site ' folder, there will be three files. A Dockerfile, .env file, and a .yml file**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
@@ -87,11 +91,11 @@
# Creating a Custom Network # Creating a Custom Network
* **Before you do anything else, you'll need to create a custom network specifically for your Wordpress sites so you don't run out of IP's which can confuse docker and cause issues with reverse proxies.** - **Before you do anything else, you'll need to create a custom network specifically for your Wordpress sites so you don't run out of IP's which can confuse docker and cause issues with reverse proxies**
* **Conveniently I made a simple batch file called 'create-docker-wordpress-network.bat' that all you need to do is double-click.** - **Conveniently I made a simple batch file called 'create-docker-wordpress-network.bat' that all you need to do is double-click**
* **It will create the network range 10.64.0.0 within Docker and then delete itself since you only need to run it once.** - **It will create the network range 10.64.0.0 within Docker and then delete itself since you only need to run it once**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
@@ -111,7 +115,7 @@
</a> </a>
</p> </p>
* **If you want to use a different network range instead of 10.64.0.0, you can right click on the batch file and change the range to whatever you want. Then save the bat file and run it.** - **If you want to use a different network range instead of 10.64.0.0, you can right click on the batch file and change the range to whatever you want. Then save the bat file and run it**
<br> <br>
@@ -119,23 +123,23 @@
# Folder Organization # Folder Organization
* **Now you'll need to organize the folder names, which is very important.** - **Now you'll need to organize the folder names, which is very important**
* **Copy the ' wp-new-site ' folder and paste it in the same directory and it should create a new folder called ' wp-new-site - Copy '. This will leave the ' wp-new-site ' folder untouched so it can remain a template that you can copy/paste as many times as you want for any new site you want to launch.** - **Copy the ' wp-new-site ' folder and paste it in the same directory and it should create a new folder called ' wp-new-site - Copy '. This will leave the ' wp-new-site ' folder untouched so it can remain a template that you can copy/paste as many times as you want for any new site you want to launch**
* **Rename the new folder you just created, ' wp-new-site - Copy ', to match your specific domain. Ex. ' wp-website-com '. You're keeping the 'wp-' part for easy filtering. You're changing the word 'new' to whatever your domain is. Then you're changing the word 'site' to whatever your domain extention is.** - **Rename the new folder you just created, ' wp-new-site - Copy ', to match your specific domain. Ex. ' wp-website-com '. You're keeping the 'wp-' part for easy filtering. You're changing the word 'new' to whatever your domain is. Then you're changing the word 'site' to whatever your domain extention is**
* So here are a couple of examples: - So here are a couple of examples:
* For 'jhammah.com', you would change 'wp-new-site' to 'wp-jhammah-com' - For 'jhammah.com', you would change 'wp-new-site' to 'wp-jhammah-com'
* For 'takedownthe.gov', you would change 'wp-new-site' to 'wp-takedownthe-gov' - For 'takedownthe.gov', you would change 'wp-new-site' to 'wp-takedownthe-gov'
* For 'dronework.pro', you would change 'wp-new-site' to 'wp-dronework-pro' - For 'dronework.pro', you would change 'wp-new-site' to 'wp-dronework-pro'
* **For this tutorial, I'll be creating a site for the domain I own, scrapyardplays.com, which means I'll change 'wp-new-site' to 'wp-scrapyardplays-com'** - **For this tutorial, I'll be creating a site for the domain I own, scrapyardplays.com, which means I'll change 'wp-new-site' to 'wp-scrapyardplays-com'**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/folder-organize-1.png" alt="Screenshot" width="1280"> <img src="https://jhammah.com/wp-content/uploads/2025/06/folder-organize-1.png" alt="Screenshot" width="1100">
</picture> </picture>
</a> </a>
</p> </p>
@@ -146,7 +150,17 @@
# Configuring .env file # Configuring .env file
* **This is the .env file. Here you will want to enter your cloudflare API token as well as the email address you log into cloudflare with. This .env file will create variables that you can reference in your Caddyfile.** - **This is the .env file. Here you will want to change the default names of things to match your new site and folder naming structure**
- **Rename the MYSQL Database**
- **Rename the MYSQL User**
- **Enter a strong MYSQL password**
- **Enter a stronger MYSQL Root password**
- **Rename the MYSQL Database Host**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
@@ -162,11 +176,11 @@
# Configuring docker-compose.yml file # Configuring docker-compose.yml file
* **Configuring docker-compose.yml file** - **Here is the docker-compose.yml file which contains all of the infor to create containers for your site**
```yml - **Open the ' docker-compose.yml ' file and you'll neet to make some mass changes which is really easy with just about any text editor**
code
``` - **You will replace all 17 occurrences of ' wp-new-site ' with your ' wp-website-com '. Most Text editors should be able to replace words in bulk. So for this tutorial, I'm replacing all 17 occurrences of ' wp-new-site ' with ' wp-scrapyardplays-com '**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
@@ -178,6 +192,8 @@ code
<br> <br>
- **Note that in the 'wordpress' container, we're not pulling an image. Instead we're referencing the 'Dockerfile' by adding the function 'build' and telling it that the Dockerfile should be in the same location as the .yml file by adding a period**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -188,6 +204,12 @@ code
<br> <br>
- **If you open the Dockerfile, you'll see that it's first line is to pull the latest wordpress image. But then you'll notice the second line which are basic Linux update commands.**
- **These lines are very important as they immediately update the core of the wordpress container's Linux environment upon container stopping and startings.**
- **With the addition of these update lines, we'll be able to use the Nano text exitor in the console when we need to adjust any PHP code.**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -198,6 +220,12 @@ code
<br> <br>
- **Next you'll be changing the port numbers. Each .yml file will be creating four containers for each website you want to launch**
- **For each service inside of the .yml file, change all of the left-ports to something you have available**
- **Only change the left-ports and leave the right-ports the same. Ex: database ####:3306, phpmyadmin ####:80, wordpress ####:80, redis ####:6379**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -206,8 +234,6 @@ code
</a> </a>
</p> </p>
<br>
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -218,6 +244,10 @@ code
<br> <br>
- **Now under the ' redis ' container, change the REDIS_DATABASE number to match which site this is for you**
- **If this is your first site, change it to ' 1 ' . If this is your second site, change it to ' 2 ', etc.**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -232,7 +262,11 @@ code
# Execute and Test # Execute and Test
* **Execute and Test** - **Alrighty. So once you've finished changing the ' wp-new-site ' text, the ports, and the redis database inside of the docker-compose.yml file, save and close it.**
- **Now you'll launch it inside PowerShell. Do this by right-clicking in an empty space in the folder where your .yml file is located and select the option ' Open in Terminal '.**
- **This will open PowerShell in the that specific directory. Type in this command and hit enter:**
```ps1 ```ps1
docker-compose up -d docker-compose up -d
@@ -248,6 +282,10 @@ docker-compose up -d
<br> <br>
- **Docker will pull the images, build the containers, and install everything under it's unique stack name while giving each container a name similar to your website. Also it will attach these containers to the wordpress-network.**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -258,6 +296,10 @@ docker-compose up -d
<br> <br>
- **Once it's done, you can now open a browser and go to ' http://localhost:#### ' (replace the #### with whatever port you chose for your Wordpress service/container)**
- **It should take you to the Wordpress setup page to finalize your install. Complete that install and then your locally hosted website will be live!**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
@@ -272,23 +314,49 @@ docker-compose up -d
# Reverse Proxy Steps # Reverse Proxy Steps
* **This is the Caddyfile. This file tells Caddy what and how to do things.** - **Now it's time to get this website attached to a domain you own as well as link it to it's Redis server to make it super fast**
- **Assuming you own a domain in Cloudflare and are using Caddy as your reverse proxy, the rest of the steps apply to you.
- **If you're using a different domain host and reverse proxy, these steps will serve as suggestions in which you will need to do research on how to acheive this with your specific setup.
- **Ultimately you'll route your reverse proxy to this localhost:#### container if you want a domain URL to reach it.**
- **So In Docker, click on your domain's stack, then click the 3 dots next to your wordpress container and select 'Open in Terminal'**
<p align="center"> <p align="center">
<a href="https://tip.jhammah.com"> <a href="https://tip.jhammah.com">
<picture> <picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/caddyfile-1.png" alt="Screenshot" width="720"> <img src="https://jhammah.com/wp-content/uploads/2025/06/php-1.png" alt="Screenshot" width="1100">
</picture> </picture>
</a> </a>
</p> </p>
- **This will launch your container's Linux terminal in which you can navigate and make changes like you would to in a Linux environment.**
<br> <br>
<br> <br>
# wp-config.php configuration # wp-config.php configuration
**wp-config.php configuration**
- **Enter this command and it will have you start editing the wp-config.php file: **
```php
nano wp-config.php
```
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/php-2.png" alt="Screenshot" width="720">
</picture>
</a>
</p>
- **Here is the code that you will copy/paste into this config file. You'll want to make the changes as I notate to match what your website name is as well as the Redis server #**
```php ```php
// Change the URL to match your actual domain address. Example for ' website.com ' // Change the URL to match your actual domain address. Example for ' website.com '
@@ -314,22 +382,92 @@ define('WP_REDIS_TIMEOUT', 1);
define('WP_REDIS_READ_TIMEOUT', 1); define('WP_REDIS_READ_TIMEOUT', 1);
``` ```
- **Here is what my code looks like with scrapyardplays.com as my domain and telling Redis that this is my 4th website**
- **Once you've made the changes, hold Control+X to exit. It will prompt you to save the changes and you select Yes**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/php-3.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
- **Now you WILL NOT be able to reach your website unless you access it via the specified domain so you'll need **
<br> <br>
<br> <br>
# Caddyfile configuration # Caddyfile configuration
**wp-config.php configuration** - **Caddyfile configuration**
```ps1 <p align="center">
docker-compose up -d <a href="https://tip.jhammah.com">
``` <picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/caddyfile-1.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
<br> <br>
<br> <br>
# Redis Plugin
- **Redis Plugin**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/plugin-1.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/plugin-2.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/plugin-3.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/plugin-4.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
<br>
<br>
# Final Test
- **Final test**
<p align="center">
<a href="https://tip.jhammah.com">
<picture>
<img src="https://jhammah.com/wp-content/uploads/2025/06/final-shot-scaled.png" alt="Screenshot" width="1100">
</picture>
</a>
</p>
<H1 align="center">Support the channel so I can make more tutorials!</h1> <H1 align="center">Support the channel so I can make more tutorials!</h1>
<H1 align="center"><a href="https://tip.jhammah.com">If this tutorial helped you out, feel free to buy me a coffee!</h1> <H1 align="center"><a href="https://tip.jhammah.com">If this tutorial helped you out, feel free to buy me a coffee!</h1>