How to upgrade
There are three ways to upgrade your Nextcloud server:
- With the Updater .
- Manually upgrading with the Nextcloud .tar archive from our Download page.
- Upgrading via the snap packages.
- Manually upgrading is also an option for users on shared hosting; download and unpack the Nextcloud tarball to your PC. Delete your existing Nextcloud files, except data/ and config/ files, on your hosting account. Then transfer the new Nextcloud files to your hosting account, again preserving your existing data/ and config/ files.
When an update is available for your Nextcloud server, you will see a notification at the top of your Nextcloud Web interface. When you click the notification it brings you here, to this page.
It is best to keep your Nextcloud server upgraded regularly, and to install all point releases and major releases. Major releases are 18, 19 or 20. Point releases are intermediate releases for each major release. For example 18.0.4 and 19.0.2 are point releases.
- Before you can upgrade to the next major release, Nextcloud upgrades to the latest point release.
- Then run the upgrade again to upgrade to the next major release’s latest point release.
- You cannot skip major releases. Please re-run the upgrade until you have reached the highest available (or applicable) release.
- Example: 18.0.5 -> 18.0.11 -> 19.0.5 -> 20.0.2
Wait for background migrations to finish after major upgrades. After upgrading to a new major version, some migrations are scheduled to run as a background job. If you plan to upgrade directly to another major version (e.g. 24 -> 25 -> 26) you need to make sure these migrations were executed before starting the next upgrade. To do so you should run the cron.php file 2-3 times, for example:
$ sudo -u www-data php -f /var/www/nextcloud/cron.php
For more information about background jobs see Background jobs .
Upgrading is disruptive. Your Nextcloud server will be put into maintenance mode, so your users will be locked out until the upgrade is completed. Large installations may take several hours to complete the upgrade. Nevertheless usual upgrade times even for bigger installations are in the range of a few minutes.
Downgrading is not supported and risks corrupting your data! If you want to revert to an older Nextcloud version, make a new, fresh installation and then restore your data from backup. Before doing this, file a support ticket (if you have paid support) or ask for help in the Nextcloud forums to see if your issue can be resolved without downgrading.
Update notifications
Nextcloud has an update notification app, that informs the administrator about the availability of an update. Then you decide which update method to use.

From there the web based updater can be used to fetch this new code. There is also an CLI based updater available, that does exactly the same as the web based updater but on the command line.
Prerequisites
If you upgrade from a previous major version please see critical changes first.
You should always maintain regular backups and make a fresh backup before every upgrade.
Then review third-party apps, if you have any, for compatibility with the new Nextcloud release. Any apps that are not developed by Nextcloud show a 3rd party designation. Install unsupported apps at your own risk. Then, before the upgrade, all 3rd party apps must be disabled. After the upgrade is complete you may re-enable them.
Maintenance mode
You can put your Nextcloud server into maintenance mode before performing upgrades, or for performing troubleshooting or maintenance. Please see Using the occ command to learn how to put your server into the maintenance mode ( maintenance:mode ) or execute repair commands ( maintenance:repair ) with the occ command.
The build-in Updater does this for you before replacing the existing Nextcloud code with the code of the new Nextcloud version.
maintenance:mode locks the sessions of logged-in users and prevents new logins. This is the mode to use for upgrades. You must run occ as the HTTP user, like this example on Ubuntu Linux:
$ sudo -u www-data php occ maintenance:mode --on
You may also put your server into this mode by editing config/config.php . Change «maintenance» => false to «maintenance» => true :
true,
Then change it back to false when you are finished.
Manual steps during upgrade
Some operation can be quite time consuming. Therefore we decided not to add them to the normal upgrade process. We recommend to run them manually after the upgrade was completed. Below you find a list of this commands.
Long running migration steps
From time to time we do some changes to the database layout that take a lot of time, but can be executed while Nextcloud stays online. Thus we moved them into a separate command that an administrator can execute on the CLI without the need to lock the instance into maintenance mode (at least for some of them). The instance will also work without those changes applied, but performance is improved significantly by them. There is also always an hint in the setup checks of the admin settings web interface.
Those include for example:
$ sudo -u www-data php occ db:add-missing-columns $ sudo -u www-data php occ db:add-missing-indices $ sudo -u www-data php occ db:add-missing-primary-keys
You can use the —dry-run option to output the SQL queries instead of executing them.
© Copyright 2024 Nextcloud GmbH.
Обновление Nextcloud

UPD: Мануал для версии 18.0.0. Скрипт стал универсальнее.
Простой рецепт обновления Nextcloud. Полезно при обновлении мажорных версий. И желательно обновлять не пропуская версии. Не забывайте перед обновлением делать бэкапы
- Nextcloud находится в директории /usr/share/nginx/nextcloud
- Новая версия: 18.0.0.
- Старая версия 17.0.1
OLD_VERSION=17.0.1 #старая версия NEW_VERSION=18.0.0 #новая версия cd /usr/share/nginx/ wget https://download.nextcloud.com/server/releases/nextcloud-$.tar.bz2 sudo -u www-data php nextcloud/occ maintenance:mode --on systemctl stop nginx mv nextcloud nextcloud-$ tar -xjf nextcloud-$.tar.bz2 cp nextcloud-$/config/config.php nextcloud/config/ chown www-data. nextcloud -R find nextcloud/ -type d -exec chmod 750 <> \; find nextcloud/ -type f -exec chmod 640 <> \; systemctl start nginx cd /usr/share/nginx/nextcloud/ sudo -u www-data php occ upgrade sudo -u www-data php occ maintenance:mode --off
Если ошибок нет, то всё прошло гладко.
Обновление до Nextcloud версии 17 1 мин для чтения


Добавить в избранное
Главное меню » Новости » Обновление до Nextcloud версии 17

Облачный сервер с открытым исходным кодом. Команда разработчиков Nextcloud выпустила 17-ю версию программного обеспечения. Вот статья, которой вы можете следовать, если у вас более старая версия установки Nextcloud, которую вы хотите обновить до последней версии.
Новые функции в Nextcloud 17
Новые функции в Nextcloud 17 включают в себя:
- Совместный редактор форматированного текста
- Удаленная очистка — позволяет администратору стирать синхронизированные данные с удаленных (мобильных) устройств.
- Безопасный почтовый ящик для Outlook
- Дополнительные параметры безопасности
- Больше возможностей для двухфакторной аутентификации
- Приложения по умолчанию обновлены
Подготовьтесь к обновлению
Основные выпуски Nextcloud должны быть обновлены в порядке возрастания, не пропуская выпуск. Вы не можете перейти с версии 15 на 17, с сначала вам нужно перейти на 16, а затем на 17.
Создание резервной копии базы данных Nextcloud и пользовательских файлов — важная задача перед запуском. Три ключевых каталога для резервного копирования:
- База данных Nextcloud (обычно хранится в mysql или mariadb).
- Каталог данных Nextcloud (по умолчанию это ваш-nextcloud-path/data)
- Каталог конфигурации Nextcloud (your-nextcloud-path/config).
Подробные инструкции по резервному копированию, описывают каждый шаг и даже содержат сценарий, который можно создать для автоматизации резервного копирования в будущем.

Как перейти на Nextcloud 17
Как говорится в документации Nextcloud, существует три способа обновления программного обеспечения:
- Запуск обновления с помощью инструмента Updater, который можно найти в панели администратора. Это самый простой метод, который мы будем использовать в этом руководстве.
- Загрузка нового пакета программного обеспечения и установка его вручную. Пользовательские данные должны быть сохранены перед установкой.
- Администраторы сервера Ubuntu Linux могут использовать инструмент, известный как snap.
Nextcloud 17 был доступен, когда мы писали эту статью, но в административной панели он был классифицирован как бета-версия. Для написания этого мы изменили наш канал обновления Nextcloud на бета-версию, хотя обычно мы обновляем только стабильные выпуски.
В любом случае, давайте начнем и пройдемся по установке с помощью инструмента Updater.
- Направьте ваш веб-браузер на Nextcloud и войдите в систему с учетной записью администратора.
- Нажмите на значок учетной записи в правом верхнем углу. В левом столбце выберите Обзор и прокрутите вниз до Версия.
- Если вы видите строку «A new version is available Nextcloud 17», нажмите Open Updater . Процесс обновления начнется.

- 4. После нескольких начальных шагов процесс останавливается и ждет, пока вы нажмете Start Update.
- 5. Программа займет некоторое время для запуска. Кроме того, устанавливаемые вами приложения Nextcloud обновляются.
- 6. После отображения «Continue to Nextcloud» , программа обновления выполнит свою работу.
- 7. Откройте Обзор в панели администратора и проверьте наличие сообщений об ошибках.
- 8. Обновите все свои мобильные приложения Nextcloud и настольные приложения.

Возможные проблемы при обновлении
Прежде чем инструмент Updater начнет установку новой версии программного обеспечения, он выполняет некоторые проверки. Вот почему вы можете увидеть сообщения об ошибках до обновления программного обеспечения.
Например, у нас было несколько дополнительных тестовых каталогов в каталоге Nextcloud, которые инструменту обновления не понравился вообще. Нам пришлось удалить каталоги и файлы, прежде чем обновитель продолжит работу.
Затем Nextcloud создает резервную копию ряда файлов. У нас было несколько версий файла конфигурации для тестирования. Опять же, инструменту Updater это не понравилось, и но он остановился. Мы должны были удалить файлы.
После того, как инструмент обновления выполнил свою работу, мы проверили раздел «Панель администратора — Обзор».
Появилось предупреждающее сообщение: «Your web server is not properly set up to resolve “/ocm-provider/»
Чтобы исправить это, отредактируйте файл конфигурации Apache в /etc/apache2/sites-available/nextcloud.conf
(или в любом другом файле конфигурации Apache Nextcloud). Вставьте две строки в файл (введите собственный путь):
Alias /ocm-provider "/var/www/nextcloud/ocm-provider/" Alias /ocs-provider "/var/www/nextcloud/ocs-provider/"
systemctl reload apache2
После обновления всех наших мобильных приложений и приложений для настольных компьютеров до последних версий и ожидания (и получения) обновлений для нескольких серверных приложений Nextcloud, выпуск 17 работал без сбоев.
Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.
Как правильно обновить NextCloud : NextCloud
Пришло время — вышла очередная версия NextCloud (удобно сделано обновление, в том числе — на телефон), как обновиться?
Сначала попробовал обновить через веб — не могло скачать, потом какой-то таймаут, потом какой-то огрызок страницы показало и закешировалось. Не рекомендую.
После того, как заклинило на «step 4 is currently in process. please reload this page later», что, скорее всего, не решится никогда, закрываете закладку с прогрессом, что дает гарантию незапуска следующего шага, идете в директорию
/var/www/nextcloud/data/updater-oc7anibltfqu
и удаляете там файлик .step, который и содержит статус обновления.
Гораздо более понятно работает скрипт обновлятора, запускаемый из под пользователя, под каким работает веб-сервер
sudo -u www-data php /var/www/nextcloud/updater/updater.phar
можно вообще, чтобы не спрашивал, воткнуть в крон, что я бы не рекомендовал делать.
sudo -u www-data php /var/www/nextcloud/updater/updater.phar --no-interaction