diff options
Diffstat (limited to 'docs/install.md')
-rw-r--r-- | docs/install.md | 27 |
1 files changed, 18 insertions, 9 deletions
diff --git a/docs/install.md b/docs/install.md index 84d218341..6cfde70ca 100644 --- a/docs/install.md +++ b/docs/install.md @@ -2,8 +2,8 @@ ## Dependencies * 64bit OS (starting with News 16.0.0) -* PHP >= 7.3 -* Nextcloud 22 +* PHP >= 8.0 +* Nextcloud (current stable version) * libxml >= 2.7.8 You also need some PHP extensions: @@ -21,16 +21,25 @@ You also need some PHP extensions: * MySQL >= 8.0 * SQLite (discouraged) -Also see the [Nextcloud documentation](https://docs.nextcloud.com/server/stable/admin_manual/configuration_database/linux_database_configuration.html?highlight=database). Oracle is currently not supported by news. +Also see the [Nextcloud documentation](https://docs.nextcloud.com/server/stable/admin_manual/configuration_database/linux_database_configuration.html?highlight=database). Oracle is currently not supported by News. ## Performance Notices * Use MySQL/MariaDB or PostgreSQL for better database performance * Use the [updater script to thread and speed up the update](https://github.com/nextcloud/news-updater) +## Cache +News and it's libraries require a writeable temporary directory used as cache. The base directory depends on your system. +You can [configure a custom directory](https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html?highlight=temp#tempdirectory) if you want. + +In most cases the base directory will be `/tmp`. News will create a folder `news-$instanceID` the [instance ID is defined by Nextcloud](https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html?highlight=temp#instanceid). + +Inside that folder a subfolder `cache` is created, inside this cache folder news and libraries will try to create cache directories for caching images, html and more. + +You need to ensure that your web-server user can write to that directory. + ## Before you install/update the News app Before you install the app do the following: -* Check that your **nextcloud/data/** directory is owned by your web server user and that it is write/readable * Check that your installation fulfills the [requirements listed above](#dependencies) * [Set up Nextcloud Background Jobs](https://docs.nextcloud.org/server/latest/admin_manual/configuration_server/background_jobs_configuration.html#cron) to enable feed updates. @@ -108,15 +117,15 @@ If you changed the temporary directory for Nextcloud you need to check on your o Careful, this next part is only intended for admins, that know what they are doing. -To remove the tables from the DB we drop the tables of news. -Your installation might have a different prefix then `oc_` but it is the default in most installations. +To remove the tables from the DB we drop the tables of News. +Your installation might have a different prefix than `oc_` but it is the default in most installations. Connect to your DB and execute the commands. Don't forget to switch to the right database. For example in mysql: `use nextcloud;` ```sql -DROP TABLE oc_news_folders; -DROP TABLE oc_news_feeds; DROP TABLE oc_news_items; +DROP TABLE oc_news_feeds; +DROP TABLE oc_news_folders; ``` Then we remove the traces in the migrations table. @@ -140,4 +149,4 @@ DELETE FROM oc_jobs WHERE class='OCA\\News\\Cron\\Updater'; DELETE FROM oc_jobs WHERE argument='["OCA\\\\News\\\\Cron\\\\Updater","run"]'; ``` -Now nothing is left from news in your nextcloud installation.
\ No newline at end of file +Now nothing is left from News in your Nextcloud installation. |