summaryrefslogtreecommitdiff
path: root/doc/update.markdown
blob: fca0d7d4333e174904ec0510143fa38618a86b84 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
Upgrade Kanboard to a new version
=================================

Most of the time, upgrading Kanboard to a newer version is seamless.
The process could be summarized to simply copy your data folder to the new Kanboard folder.
Kanboard will run database migrations automatically for you.

Important things to do before updating
--------------------------------------

- **Always make a backup of your data before upgrading**
- **Check that your backup is valid!**
- Check again
- Always read the [change log](https://github.com/kanboard/kanboard/blob/master/ChangeLog) to check for breaking changes
- Always close all user sessions (flush all sessions on the server)

From the archive (stable version)
---------------------------------

1. Decompress the new archive
2. Copy the `data` folder into the newly uncompressed directory
3. Copy your custom `config.php` if you have one
4. If you have installed some plugins, use the latest version
5. Make sure the directory `data` is writeable by your web server user
6. Test
7. Remove your old Kanboard directory

From the repository (development version)
-----------------------------------------

1. `git pull`
2. `composer install --no-dev`
3. Login and check if everything is ok

Note: This method will install the **current development version**, use at your own risk.