mirror of
https://github.com/cytopia/devilbox.git
synced 2024-12-24 15:06:41 +00:00
88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
# Updating
|
|
|
|
This document will hold all information on how to update between major versions.
|
|
|
|
|
|
## Update from `v2.4.0` to `v3.0.0` (`v3.0.0-beta-1`)
|
|
|
|
**PR:** https://github.com/cytopia/devilbox/pull/942
|
|
|
|
This PR introduces new `.env` variables, so you are required to copy `env-example` over to `.env`.
|
|
Also ensure to stop and remove containers.
|
|
```bash
|
|
docker-compose stop
|
|
docker-compose rm -f
|
|
```
|
|
|
|
## Update from `v1.8.1` to `v1.8.2`
|
|
|
|
**PR:** https://github.com/cytopia/devilbox/pull/750
|
|
|
|
This PR adds many new images, ensure to remove your current old state before running them:
|
|
```bash
|
|
docker-compose stop
|
|
docker-compose rm -f
|
|
```
|
|
|
|
|
|
## Update from `v1.8.0` to `v1.8.1`
|
|
|
|
**PR:** https://github.com/cytopia/devilbox/pull/747
|
|
|
|
This PR ensures to have all directories in log/ mod/ cfg/ added by default. Prior this, some
|
|
of those directories might have been created by Docker (running as root) and they have the wrong
|
|
permissions (root instead of local user).
|
|
To mitigate this, you need to adjust directory permissions prior pulling this tag.
|
|
|
|
```bash
|
|
sudo chown -R <user>:<group> .
|
|
```
|
|
|
|
|
|
## Update from `v1.6.2` to `v1.6.3`
|
|
|
|
**PR:** https://github.com/cytopia/devilbox/pull/689
|
|
|
|
The following affects you if you have a PostgreSQL root password set:
|
|
|
|
Ensure to diff `env-example` against `.env` as a new environment variable (`PGSQL_HOST_AUTH_METHOD`)
|
|
has been introduced. A default value has been set in `docker-compose.yml` to make migration seamless.
|
|
|
|
|
|
## Update from `v1.1.0` to `v1.2.0`
|
|
|
|
**PR:** https://github.com/cytopia/devilbox/pull/647
|
|
|
|
This release changes the way the SSL CA and certificates are generated.
|
|
Background here: https://support.apple.com/en-us/HT210176
|
|
|
|
In order to use the new CA, you will need to delete your current CA in `ca/devilbox-ca.*`.
|
|
A new one will be automatically generated if none is present. Additionally you will have to
|
|
import the CA again in your browser(s).
|
|
|
|
|
|
## Update from `v0.x.y` to `v1.x.y`
|
|
|
|
#### Docker Volumes
|
|
|
|
**PR:** https://github.com/cytopia/devilbox/pull/383
|
|
|
|
This feature will move all data directories (MySQL, PostgreSQL, MongoDB and others) to Docker
|
|
volumes for best-practice and compatibility reasons on different operating systems.
|
|
|
|
Before updating to this release, you will need to manually trigger a backup of MySQL,
|
|
PostgreSQL and MongoDB to ensure that you have a copy of your data. By switching to this release
|
|
you will be unable to access your current data:
|
|
|
|
**Steps to update:**
|
|
|
|
1. Backup your data
|
|
2. Switch to the new release
|
|
3. Import your data
|
|
|
|
**Documentation:**
|
|
|
|
* [Backup Mysql](https://devilbox.readthedocs.io/en/latest/maintenance/backup-and-restore-mysql.html)
|
|
* [Backup PostgreSQL](https://devilbox.readthedocs.io/en/latest/maintenance/backup-and-restore-pgsql.html)
|
|
* [Backup MongoDB](https://devilbox.readthedocs.io/en/latest/maintenance/backup-and-restore-mongo.html)
|