Skip to content

System Requirements

Marius David Wieschollek edited this page Dec 27, 2022 · 77 revisions

This page is about the system requirements for the Passwords app for Nextcloud. We also list the system requirements for the latest Nextcloud version since Google keeps recommending this site instead of the official system requirements for Nextcloud page.

Nextcloud 25 Passwords App Recommended
Processor 64-bit CPU 2x1 GHz 4x2 GHz
RAM 512Mib 512 MiB 8 GiB
Disk 256Mib 2 GiB 64 GiB
Nextcloud 25 25 25
OS Ubuntu 22.04 LTS/20.04 LTS, Red Hat Enterprise Linux 8, Debian 11, SUSE Linux Enterprise Server 15, openSUSE Leap 15.4, CentOS Stream Linux Ubuntu 22.04
Database MySQL 8.0+ or MariaDB 10.3+, PostgreSQL 10+, SQLite MariaDB / MySQL / PostgreSQL / Sqlite MariaDB 10.7
PHP 8.1, 8.0, 7.4 (deprecated) 8.1, 8.0 PHP 8.1
Webserver Apache 2.4 with mod_php or php-fpm, nginx with php-fpm HTTPS nginx 1.23 with php-fpm & HTTPS
PHP Extensions ctype, curl, dom, fileinfo, GD, JSON, libxml, mbstring, openssl, posix, session, SimpleXML, XMLReader, XMLWriter, zip, zlib, pdo_sqlite, pdo_mysql, pdo_pgsql, filter (only on Mageia and FreeBSD), hash (only on FreeBSD) intl intl, zip, imagick
Libraries libxml2 >=2.7.0 imagemagick, librsvg, wbritish, wamerican, wngerman, wfrench, wspanish, witalian, wportuguese

** Recommendations are in bold

LSR/Legacy Support Releases

Legacy support releases are provided for servers which run a PHP version that is not supported by the passwords app, but by any version of Nextcloud that is support. LSR builds are generated by an automated process during the release which rewrites the source code of the app to work with an older PHP language level. This means that the source code of LSR builds does not match the source code in our repositories and the build is also not tested before the release. We can only provide LSR builds as long as the automatic conversion is possible so LSR builds may end without any notice if that is not possible.

Minimum Recommended
Processor 2x1 GHz 4x2 GHz
RAM 512 MiB 8 GiB
Disk 2 GiB 64 GiB
Nextcloud 25 25
OS Linux Ubuntu 22.04
Database MariaDB / MySQL / PostgreSQL / Sqlite MariaDB 10.7
PHP 7.4 7.4
Webserver HTTPS Nginx 1.23 HTTPS
PECL intl intl, zip, imagick
Libraries imagemagick, librsvg, wbritish, wamerican, wngerman, wfrench, wspanish, witalian, wportuguese

Since systems using LSR builds do not meet the minimum requirements, no official support is provided by us. If you experience any issues, visit the forum or the chat groups for help.

Version scheme and breaking changes

Passwords versions are simply the year and month of the release of the version. The exact version scheme is <year>.<month>.<bugfix>. In accordance with SemVer2.0.0, only the first version of a new year will introduce breaks in backward compatibility. With the first release of the year, the support for any Nextcloud version but the latest as well as any PHP version without active support will be ended.

HTTPS requirement

Passwords requires HTTPS to work. This can not be disabled. Please take a look at the Nextcloud documentation to configure your server correctly. If you use a proxy or separate ssl termination point, configure your Nextcloud accordingly. You can get a free HTTPS certificate from Let's Encrypt.

Background Jobs

Passwords uses several background jobs to process data. To ensure that these run as intended, it is recommended to configure Nextcloud to run those jobs trough cron. Using webcron or ajax for background jobs will cause long delays when passwords are shared since these options will only execute one background job with each call. Using ajax for background jobs may also cause unexpected issues since this will execute background jobs in the user scope instead of the global scope. More information can be found in the documentation.

Browser Support

We support the current version of Chrome and Firefox and assume that most browsers based on these will work as well. We do not support specific configurations or browser extensions.

PHP Requirements

We support only versions of PHP with active support by the PHP community. The app may run with older PHP versions but this is not tested and bug reports with an unsupported version will be ignored.

To keep your PHP version updated, we recommend the PHP PPA from deb.sury.org for Ubuntu and Debian.

If you use NextcloudPi, you can use our NextcloudPi PHP 8.0 upgrade guide.

If you use DietPi, check the guide for your webserver choice.

Third Party Services

To provide all api features, passwords may use third party services depending on the settings. The following list contains all domains which may provide these services. However, some local service providers like Pageres and the favicon finder may contact any domain as requested via the api. The user handbook also makes direct requests to external servers from the user browser and your server.

Licenses

All licensing information can be found in the Licenses.md file

Clone this wiki locally