移至檔案
Côme Chilliet 072003a652
Merge pull request #540 from nextcloud/revert-535-master
Revert "Also include *.config.php files"
2024-03-18 09:49:14 +01:00
.github chore(ci): Fetch all commits for check-same-code-base 2024-01-29 11:06:00 +01:00
lib Revert "Also include *.config.php files" 2024-03-14 15:39:52 +01:00
tests Bump behat/behat from 3.11.0 to 3.13.0 in /tests 2024-01-29 10:28:40 +01:00
vendor chore: make updater.phar index.php 2024-02-05 17:14:32 +01:00
vendor-bin chore: use Nextcloud coding standards v1.1.1 2023-10-31 17:44:22 +01:00
.gitignore fix: update composer deps and box build workflow 2023-06-08 17:58:35 +02:00
.php-cs-fixer.dist.php chore: use Nextcloud coding standards v1.1.1 2023-10-31 17:44:22 +01:00
Changelog.md Check if update should be run based on updater server response 2016-12-07 13:05:08 +01:00
LICENSE add AGPL license file - fixes #76 2017-01-12 23:37:28 +01:00
Makefile fix: update composer deps and box build workflow 2023-06-08 17:58:35 +02:00
README.md docs(README): Establish a basic initial README for Updater (#539) 2024-03-12 09:36:48 +01:00
box.json Remove unused file version.php 2024-01-29 09:10:28 +01:00
buildVersionFile.php add version number 2016-11-25 16:04:00 +01:00
composer.json Bump symfony/console from 4.4.49 to 5.4.34 2024-01-29 11:06:00 +01:00
composer.lock Bump nextcloud/coding-standard from 1.1.1 to 1.2.1 2024-03-01 02:26:14 +00:00
index.php Revert "Also include *.config.php files" 2024-03-14 15:39:52 +01:00
index.web.php Fix getUpdateStepFileLocation return type and call 2023-08-03 16:59:44 +02:00
psalm.xml Improve typing and remove PHP 5.4 hacks 2023-08-03 16:55:38 +02:00
updater.phar Revert "Also include *.config.php files" 2024-03-14 15:39:52 +01:00
updater.php composer run cs:fix 2022-08-01 10:19:58 +02:00

README.md

🔄 Nextcloud Updater

🔄 The built-in Updater keeps your Nextcloud Server installation up-to-date. In many cases it can be used in place of the manual update process.

image

Background

[!NOTE] The built-in Updater is primarily applicable to manual/Archive (aka: "tarball") installations. Most other installation methods (such as Docker images and Snaps) utilize their own officially supported processes for keeping Nextcloud Server up-to-date. Please follow their respective documented approaches rather than trying to run the Updater yourself.

Configuration

No special configuration parameters are generally required for the Updater. There are some optional parameters which may be of interest in some environments:

Usage

The built-in Updater can be used in two ways: via the Web UI and via the command-line. The former is more convenient, but the latter is more reliable.

[!WARNING] Please make a backup and familiarize yourself with the restore process before proceeding with using the Updater.

Web

Go to Administration settings. It's in the Overview (under the Update heading). If the updatenotifications app is enabled you will also receive notifications when new versions of Server are published.

See Using the web based updater in the Nextcloud Administration Manual.

Command-line

See Using the command line based updater

updater.phar

Parameters:

--no-backup              Don't create a backup of the application code (note: the Updater's backup *never* backs up data or databases contents)
--no-upgrade             Don't automatically run `occ upgrade` when the Updater finishes (note: `occ upgrade` is required after Updater updates the application code in order to push out any database changes in the newly deployed version of Nextcloud)

Troubleshooting

Logging

  • The Updater operates independently from Server so it has it's own log file called updater.log which is located in the configured datadirectory for the instance.

Unable to use the built-in Updater

If the built-in Updater does not function reliably for your environment, the old reliable (albeit admittedly tedious) manual update process may be your best alternative. This was the primary way of keeping Nextcloud Server up-to-date before the automated Updater was developed. In addition, if Updater does not work in your environment, report the details of your situation to https://github.com/nextcloud/updater/issues so that consideration can be given to adapting Updater to a wider variety of environments.

Updater != occ upgrade

The occ upgrade command runs the database migrations which adapt your existing database to the updated version Nextcloud Server that is deployed by the Updater (or via a manual update).

Despite the confusing naming - which makes sense technically, but in hindsight may not have been the best to avoid confusion - the Updater must run (and completely successfully) before occ upgrade will have anything to do.

Getting Help

https://help.nextcloud.com

Suggesting enhancement ideas or reporting possible bugs:

https://github.com/nextcloud/updater/issues

[!TIP] Since bug reports are not for technical support, you may not receive a personalized or timely response. If you suspect you may have encountered a previously unknown bug, please try to troubleshoot it in the Help Forum first.

Contributing

If you have found a possible solution to a reported bug or an enhancement idea, please submit a PR.