diff options
Diffstat (limited to 'doc/en_US/update.markdown')
-rw-r--r-- | doc/en_US/update.markdown | 53 |
1 files changed, 0 insertions, 53 deletions
diff --git a/doc/en_US/update.markdown b/doc/en_US/update.markdown deleted file mode 100644 index dc2fb48e..00000000 --- a/doc/en_US/update.markdown +++ /dev/null @@ -1,53 +0,0 @@ -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!** -- Always read the [ChangeLog](https://github.com/kanboard/kanboard/blob/master/ChangeLog) for breaking changes -- Stop the worker if you use it -- Put the web server in maintenance mode to avoid people to use the software while upgrading - -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. Login and check if everything is ok - -- This method will install the **current development version**, use at your own risk. -- Do not update the software blindly without checking the [ChangeLog](https://github.com/kanboard/kanboard/blob/master/ChangeLog). - -Running SQL migrations manually -------------------------------- - -By default, SQL migrations are executed automatically. The schema version is checked at each request. -In this way, when you upgrade Kanboard to another version, the database schema is updated for you. -This method **is not perfect**. - -- **When you run the migrations, make sure only one process is accessing to the database** -- Put your Kanboard instance in "maintenance mode" to avoid people using the software while you are altering the database schema - -To disable this feature, set the parameter `DB_RUN_MIGRATIONS` at `false` in your [config file](config.markdown). - -When you will have to upgrade Kanboard, run this command: - -```bash -./cli db:migrate -``` |