switch-amd64-to-arm.md

1. Stop and remove all Docksal services

First, ensure that all running Docksal services are stopped:

fin stop

2. Remove the project’s containers and volumes

Next, remove the project’s containers and associated volumes:

fin project remove --volumes

This command will:

• Stop the project containers
• Remove the project containers
• Delete the project’s volumes, ensuring any data stored in them is also removed

3. Purge global Docksal services

If you also want to remove any global Docksal services (like DNS, SSH agent, etc.):

fin system reset

4. Rebuild the project environment

After removing the old environment, you can recreate it by running:

fin project start

This will rebuild the containers and volumes from scratch using your project’s .docksal configuration.

5. Clear any residual data

⚠️ NOTE: This may destroy all other projects, not just this one! This is the BFG9000 resolution. This step is not required and you can stop.

If you suspect there might still be residual data or configurations causing issues, you can clear the Docker system entirely (including all volumes, networks, images, and containers across all projects). This is a destructive operation and should be used with caution:

docker system prune --volumes -a

After completing these steps, your Docksal environment will be entirely reset, and you can start with a clean slate.