Update the Devilbox

If you are in the initial install process, you can safely skip this section and come back once you actually want to update the Devilbox.

Table of Contents

local

Update git repository

Stop container

Before updating your git branch or checking out a different tag or commit, make sure to properly stop all devilbox containers:

# Stop containers
host> cd path/to/devilbox
host> docker-compose stop

# Ensure containers are stopped
host> docker-compse ps

Case 1: Update master branch

If you simply want to update the master branch, do a git pull origin master:

# Update master branch
host> cd path/to/devilbox
host> git pull origin master

Case 2: Checkout release tag

If you want to checkout a specific release tag (such as 0.12.1), do a git checkout 0.12.1:

# Checkout release
host> cd path/to/devilbox
host> git checkout 0.12.1

Keep `.env` file in sync

Warning

Whenever you check out a different version, make sure that your .env file is up-to-date with the bundled env-example file. Different Devilbox releases might require different settings to be available inside the .env file.

You can also compare your current .env file with the provided env-example file by using your favorite diff editor:

host> vimdiff .env env-example

host> diff .env env-example

host> meld .env env-example

Recreate container

Whenever the path of a volume changes (either due to upstream changes in git or due to you changing it manually in the .env file) you need to remove the stopped container and have them fully recreated during the next start.

# Remove anonymous volumes
host> cd path/to/devilbox
host> docker-compose rm

remove_stopped_container

Update Docker images

Updating the git branch shouldn't be needed to often, most changes are actually shipped via newer Docker images, so you should frequently update those.

This is usually achieved by issueing a docker pull command with the correct image name and image version. For your convenience there is a shell script in the Devilbox git directory: update-docker.sh which will update all available Docker images at once.

# Update docker images
host> cd path/to/devilbox
host> ./update-docker.sh

Note

The Devilbox own Docker images (Apache, Nginx, PHP and MySQL) are even built every night to ensure latest security patches and tool versions are applied.

Checklist git repository

Ensure containers are stopped and removed/recreated
Ensure desired branch, tag or commit is checked out or latest changes are pulled
Ensure .env file is in sync with env-example file

Checklist Docker images

Ensure ./update-docker.sh is executed

3.3 KiB Raw Blame History