mailcow-dockerized-docs/docs/install-update.md
Phoenix Eve Aspacio 7dee5d4e8c typo
2017-06-07 05:37:02 +08:00

2,5 KiB

There is no update routine. You need to refresh your pulled repository clone and apply your local changes (if any). Actually there are many ways to merge local changes.

Step 1, method 1

Stash all local changes, pull changes from the remote master branch and apply your stash on top of it. You will most likely see warnings about non-commited changes; you can ignore them:

# Stash local changes
git stash
# Re-pull master
git pull
# Apply stash and remove it
git stash pop

Step 1, method 2

Fetch new data from GitHub, commit changes and merge remote repository:

# Get updates/changes
git fetch
# Add all changed files to local clone
git add -A
# Commit changes, ignore git complaining about username and mail address
git commit -m "Local config at $(date)"
# Merge changes
git merge

If git complains about conflicts, solve them! Example:

CONFLICT (content): Merge conflict in data/web/index.php

Open data/web/index.php, solve the conflict, close the file and run git add -A + git commit -m "Solved conflict".

Step 1, method 3

Thanks to fabreg @ GitHub!

In case both methods do not work (for many reason like you're unable to fix the CONFLICTS or any other reasons) you can simply start all over again.

Keep in mind that all local changes to configuration files will be lost. However, your volumes will not be removed.

  • Copy mailcow.conf somewhere outside the mailcow-dockerized directory
  • Stop and remove mailcow containers: docker-compose down
  • Delete the directory or rename it
  • Clone the remote repository again (git clone https://github.com/mailcow/mailcow-dockerized && cd mailcow-dockerized). Pay attention to this step - the folder must have the same name of the previous one!
  • Copy back your previous mailcow.conf into the mailcow-dockerized folder

If you forgot to stop Docker before deleting the cloned directory, you can use the following commands:

docker stop $(docker ps -a -q)
docker rm $(docker ps -a -q)

Step 2

When upgrading from a version older than May 13th, 2017 to a version released after that date, you need to run the following command first as network settings have been changed:

docker-compose down

Pull new images (if any) and recreate changed containers:

docker-compose pull
docker-compose up -d --remove-orphans

Step 3

Clean-up dangling (unused) images and volumes:

docker rmi -f $(docker images -f "dangling=true" -q)
docker volume rm $(docker volume ls -qf dangling=true)