CasaOS- Wordpress error - No manifest in linux/arm64/v8

BigBearCasaOS
3

Hi everyone,

If you’re facing the error “no matching manifest for linux/arm64/v8 in manifest list” while trying to install WordPress (or other Docker images) on your Raspberry Pi with CasaOS, I’ve found a workaround that might help.

Step-by-Step Workaround

This issue occurs because Docker isn’t pulling the correct image version for the Raspberry Pi’s ARM architecture. Here’s how to force Docker to use the correct platform:

  1. Check Your Architecture:

    Run the following command to check your system architecture:

    uname -m

    If your output is aarch64, proceed with the next steps.

  2. Set Docker to Use ARM64 by Default:

    Run the following commands to create a configuration for Docker to use the ARM64 platform:

    sudo mkdir -p /etc/systemd/system/casaos-app-management.service.d/
echo -e "[Service]\nEnvironment=\"DOCKER_DEFAULT_PLATFORM=linux/arm64\"" | sudo tee /etc/systemd/system/casaos-app-management.service.d/docker-platform.conf
sudo systemctl daemon-reload
sudo systemctl restart casaos-app-management
sudo systemctl restart docker

    Important: Make sure to back up any important data before proceeding.

  3. Restart Docker Services:

    These commands will reload the systemd configuration and restart both CasaOS App Management and Docker services to apply the changes.

After completing these steps, Docker should pull the correct linux/arm64 image, and you should no longer encounter the manifest error.