https://github.com/novuslogic/BashNovusTools

Using WordPress on AWS Lightsail and Docker

Summary

The AWS CLI is a command-line tool that lets you manage and automate AWS services including Lightsail using PowerShell, Command Prompt, or Terminal. With AWS CLI, you can automate tasks, configure AWS resources, and streamline the deployment and management of Lightsail instances, Docker containers, and WordPress environments.

Prerequisites

• Python (if applicable):
  • Required only for AWS CLI v1 (installed via pip): Python 3.7 or later recommended.
  • AWS CLI v2: Python is bundled; you don’t need to install it separately.
• Administrator or sudo privileges: Required for installation and configuration on most systems.

Installation

Tip: All commands below should be run in your system’s terminal, PowerShell, or command prompt.

Windows

Option 1: MSI Installer

1. Download the installer from the official AWS CLI documentation.
2. Run the installer (e.g., AWSCLIV2.msi).Or, run this command:msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi

Option 2: Chocolatey

Chocolatey is a command-line package manager for Windows.

To install or upgrade AWS CLI:

choco upgrade awscli

Verify Installation

aws --version

Linux

Option 1: Official Bundled Installer

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
rm -rf awscliv2.zip aws/

Option 2: Snap (Ubuntu/Debian)

sudo snap install aws-cli --classic

Verify Installation

aws --version

macOS

Option 1: Homebrew

brew update
brew install awscli

Verify Installation

aws --version

Creating an IAM User Group for Lightsail Access

You can use either a service-linked role (created automatically by Lightsail) or set up a custom role with your own group and permissions.

1. Sign in to the AWS Management Console

• Go to the IAM (Identity and Access Management) service (search for “IAM” in the AWS Console search bar).

2. Create a User Group

• Navigate to User groups ? Create group.
• Name your group (e.g., LightsailUsers).
• (Optional) Add users now, or skip and add later.
• Click Next.

3. Attach Permissions

• In Attach permissions policies, search for AdministratorAccess.
• Check the box for AdministratorAccess.
• Click Next, then Create group.

4. Add Users (if you didn�t earlier)

• In User groups, select your group.
• Go to the Users tab, click Create user.

5. Create User & Access Key

• Set a username (e.g., developer).
• Leave console access unchecked (optional).
• On Permissions, choose Add user to group and pick LightsailUsers.
• Skip permission boundaries (optional).
• Click Create user.

Create Access Key:

• In Users, click your user’s name.
• Go to Security credentials tab, click Create access key.
• Select Command Line Interface (CLI).
• Confirm recommendations and continue.
• Download your credentials .csv and store securely.

Tip: Tags (key-value pairs) can help organize and automate your Lightsail resources.

AWS CLI Configuration

1. Run the aws configure Command

aws configure

You’ll be prompted for:

• AWS Access Key ID: (From your downloaded .csv)
• AWS Secret Access Key: (From your downloaded .csv)
• Default region name: (e.g., ap-southeast-2)
• Default output format: (json, text, or table)

These are stored as your default profile.

2. Add Additional Profiles (Optional)

You can create multiple named profiles (for different users/accounts):

aws configure --profile MyUbuntuProfile

3. Where Profiles Are Stored

Profiles are kept in two files:

• Linux/macOS: ~/.aws/
• Windows: C:\Users\<YourUsername>\.aws\

Files:

• credentials – stores access keys
• config – stores region and output format

Example:

~/.aws/credentials

[default]
aws_access_key_id = AKIAEXAMPLE1
aws_secret_access_key = secret1

[MyUbuntuInstance]
aws_access_key_id = AKIAEXAMPLE2
aws_secret_access_key = secret2

~/.aws/config

[default]
region = ap-southeast-2
output = json

[profile MyUbuntuInstance]
region = us-west-2
output = table

Using Multi-Profiles

Multi-profiles allow you to easily switch between AWS accounts, users, or environments from a single machine.

• View all profiles:aws configure list-profiles
• Use a profile:aws s3 ls --profile default aws ec2 describe-instances --profile MyUbuntuProfile

Further Reading

• AWS CLI Official Docs – Installation & Configuration

Using WordPress on AWS Lightsail and Docker

Summary

For Local Docker Development. We could use Docker Engine, which is the primary container runtime that runs directly on Linux and Windows servers. It is built for production use because it is lightweight, stable, and can be automated with command-line tools, system services, and CI/CD pipelines. This setup provides the performance and control necessary to run applications at scale. On the other hand, Docker Desktop is meant for development on macOS, Windows, and Linux desktops. It includes Docker Engine inside a small virtual machine and adds a graphical dashboard, resource controls, Docker Compose, and optional Kubernetes for local testing. In short, Docker Engine runs containers in production, while Docker Desktop provides the developer with an easy way to build, test, and debug containers locally before deploying them to production.

We will install Docker Desktop for our development work on either Windows, Linux, or macOS.

Installing Docker Desktop

Windows 11 or higher

1. Prerequisites

Before installing Docker Desktop on Windows:

• Windows Version: You need Windows 11 or a newer version. Docker Desktop uses Hyper-V and WSL2.
• Hardware Requirements: Your system must support virtualization technology enabled in BIOS. Docker Desktop for Windows requires at least 4GB RAM and recommends SSD storage for optimal performance.
• Licensing: Docker Desktop is free for individuals, education, and small businesses (< 250 employees or < $10 million revenue). Large enterprises need a paid plan.

2. Install WSL2:

• 1. Open PowerShell as an Administrator, then enter the following command.

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

This enables the core WSL feature on your system.

• 1. Enable Virtual Machine Platform

WSL 2 requires the Virtual Machine Platform feature to run the Linux kernel:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• 1. Set WSL 2 as the Default Version

wsl --install
wsl --set-default-version 2

If prompted, please reboot your system and launch Ubuntu from the Microsoft Store once to complete the setup.

3. Download and install Docker Desktop for Windows.

1. Install via GUI (Recommended for Most Users) – Download Manually

The simplest and most popular way to install Docker Desktop on Windows 11 or higher is described here.

Go to the official download page:

Install Docker Desktop on Windows

• 1. Click Download Docker Desktop for Windows.
• 1. Save the file (for example, Docker Desktop Installer.exe).
• 1. Double-click the installer to start setup.

2. Curl with CMD or Powershell

Below is a single CMD command to download and silently install Docker Desktop with the WSL 2 backend. Please run as Administrator.

curl -L "https://desktop.docker.com/win/main/amd64/Docker%%20Desktop%%20Installer.exe" -o "%TEMP%\DockerDesktopInstaller.exe" && start /w "" "%TEMP%\DockerDesktopInstaller.exe" install --accept-license --quiet --backend=wsl-2

3. Chocolatey

To install Docker Desktop on Windows using Chocolatey, run the following, Open PowerShell as Administrator and run:

1. Check if Chocolatey is installed

choco -v

If a version number, such as 2.2.2, appears, the process is complete. If not, please install it using the following command:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

2. Install Docker Desktop

choco install docker-desktop -y

• choco Chocolatey command-line tool.
• install Checks for a lastest version of the package and installs it.
• docker-desktop The name of the Docker Desktop package.
• -y automatically accepts prompts.

3. Update Docker Desktop

 choco upgrade docker-desktop -y
`

• choco Chocolatey command-line tool.
• upgrade Checks for a newer version of the package and installs it.
• docker-desktop The name of the Docker Desktop package.
• -y automatically accepts prompts.

Install on macOS

1. Prerequisites

Before installing Docker Desktop on macOS:

• MacOS Version Requires macOS Monterey (12) or newer.
• Hardware Requirements You need an Intel or Apple Silicon (M1, M2, M3, or newer) CPU, at least 4 GB of RAM, and 2 GB of free disk space.
• Virtualization Make sure Rosetta 2 is enabled for Apple Silicon, or Hypervisor Framework is enabled for Intel.
• Licensing Same free-tier rules apply as Windows.

Docker Desktop for macOS can be installed in three ways:

1. Install via GUI (Recommended for Most Users)

• 1. Download Installer – Visit the official Docker Desktop for Mac download page Install Docker Desktop on Mac.
• 1. Choose the correct version and download:
     • Apple Silicon Docker.dmg Apple Chip
     • Intel Docker.dmg Intel Chip
• 1. Open the Installer
     • Double-click the downloaded .dmg file.
     • Drag the Docker.app icon into the Applications folder.
• 1. Launch Docker Desktop
     • Open Applications folder and launch Docker.app.
     • The first time you open the program, you might be asked to enter your system password.
     • Wait for the whale docker icon to appear in the macOS status bar.

2. Using Homebrew (Command Line Install) Homebrew

Homebrew is a package manager for macOS that simplifies installing applications from the command line.

• 1. Open the Terminal App, in Terminal run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• 1. Once installed, verify:

brew --version

• 1. Install Docker Desktop via Homebrew

Homebrew downloads and installs the latest version of Docker Desktop that works with your Mac�s architecture, whether it is Intel or Apple Silicon.

brew install --cask docker

• 1. Once the installation is complete, open Docker Desktop. Wait until you see the whale Docker icon in the macOS status bar.

open /Applications/Docker.app

3. Using Mac App Store (Apple Silicon only)

• 1. Open the Mac App Store
• 1. In the top-left corner of the App Store window, click the Search bar.
• 1. Type Docker Desktop and press Return.
• 1. You should see the official app listed as Docker Desktop Developer Tools by Docker Inc.
• 1. macOS will automatically download and install Docker Desktop in your Applications folder. Please wait until the download finishes.
• 1. Once the installation is complete, open Docker Desktop. Wait until you see the whale Docker icon in the macOS status bar.

open /Applications/Docker.app

Install on Linux (Ubuntu 24.04)

• 1. Add Official Docker Repository

Before you install Docker Desktop, you need Docker’s CLI and daemon packages to be available through its official repositories

Open a terminal (Ctrl+Alt+T) and run the following:

sudo apt update
sudo apt install apt-transport-https ca-certificates curl gnupg -y

These packages enable HTTPS access to repositories and manage trusted keys.

Now, import the Docker GPG key and add the official Ubuntu repo:

sudo apt install apt-transport-https ca-certificates curl gnupg
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu noble stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Then update your package index:

sudo apt update

• 1. Download the Docker Desktop .deb Package

Docker Desktop for Linux comes as a .deb file. To get the latest version, you can use curl

curl -fsSL -o docker-desktop.deb https://desktop.docker.com/linux/main/amd64/docker-desktop-latest.deb

• 1. Install Docker Desktop

After you download the package, use apt to install it. This will make sure all the needed dependencies are installed automatically.

sudo apt install ./docker-desktop.deb

This process installs Docker Desktop and its main components, such as:

    * Docker Engine
    * Docker CLI (docker command)
    * Docker Compose
    * Docker Desktop system service

• 1. Enable User Access to Docker

If you want to run Docker commands without using sudo, add your user to the docker group. The newgrp command lets you apply your group changes right away, so you do not need to log out first.

sudo usermod -aG docker $USER
newgrp docker
`

• 1. Launch Docker Desktop

Now you can start Docker Desktop with

systemctl --user start docker-desktop
`

Verify Docker Desktop Installation

• 1. Start Docker Desktop
• Windows: Find “Docker Desktop” in the Start Menu and open it. You should then see the Docker whale icon in the system tray.
• Mac: Open your Applications folder, find “Docker Desktop,” and start it. The Docker whale icon will show up in the menu bar.
• Linux (Ubuntu 24.04): The location and icon for launching Docker Desktop can vary depending on your Linux distribution. Check your distribution’s documentation or search for “Docker Desktop” in your application launcher for more information.
• 1. Verify Docker Engine and Client

Open your terminal, command prompt, then run this command.

docker --version

This command shows the version of the Docker client and engine, so you can check that Docker is installed and working from your command line.

• 1. Run a Test Container

Execute the “hello-world” container to verify that Docker can pull images, create and run containers, then run this command.

docker run hello-world

If the process works correctly, you will see a message

Hello from Docker!
This message shows that your installation appears to be working correctly.

This confirms that the Docker engine, container networking, image pulling, and runtime execution are functioning correctly.

Further Reading

• How to install Linux on Windows with WSL
• Installing Chocolatey
• Install Docker Desktop on Windows
• Install Docker Desktop on Mac
• Homebrew
• Install Docker Desktop on Linux (Ubuntu Example)

Learn how to deploy WordPress on AWS Lightsail using Docker.

This book provides a clear, step-by-step guide to setting up the AWS CLI, creating a Lightsail virtual server, installing Docker, and deploying WordPress with Docker Compose.
You will also explore how to automate WordPress theme deployments using WP-CLI and CI/CD pipelines.

It is designed for developers, site owners, and technical users who want a simpler, more reliable, and more secure approach to WordPress deployment using DevOps practices.

Early Access Edition

Using WordPress on AWS Lightsail and Docker

https://github.com/novuslogic/NovuscodeLibrary

Changelog

ToDo

https://github.com/novuslogic/NovuscodeLibrary

The next big goal will be a Documentation Wiki using CodeImatic.codegen – CodeDoc plugin. Still a work in progress.

https://github.com/novuslogic/NovuscodeLibrary/issues/11

Also an upgrade and new samples.

https://github.com/novuslogic/NovuscodeLibrary/issues/12

Changelog

ToDo

Some people have loss their jobs, or had reduced hours in my case I have been hyper-busy with my main employment.

It seems my work still is keeping me away, from my side projects and adding content to this blog. However, some progress has happened.

So my thoughts for the new year … more time on my side projects with luck.

Say safe and happy new year.

https://github.com/novuslogic/DelphiAWSSDK/releases/tag/v0.3.0

Summary of updates

• New Lazarus CreateTable1 DynamoDB Sample
• Refactored Core for Lazarus / fpc 1.8 or higher
• Moved Samples Samples\DynamoDB to Samples\DynamoDB\Delphi

https://github.com/novuslogic/DelphiAWSSDK/releases/tag/v0.2.0

Summary of updates

• Updated support Delphi XE to Delphi X10.2
• Tested support for Windows 32/64Bit, MacOSX 32Bit
• New TAmazonIndyRESTClient and TAmazonDelphiRESTClient classes
• Updated TAmazonSignatureV4 class to be less reliant on Indy,  allowing for cross-platform development.
• THashSHA2 supported in unit Amazon.Utils for Delphi XE8 and up.