Preferred Installation Method

For production environments, we recommend the installation from the tar archive. This applies in particular to scenarios, where the Web server, storage and database are on separate machines. In this constellation, all dependencies and requirements are managed by the package management of your operating system, while the ownCloud code itself is maintained in a sequence of simple steps as documented in our instructions for the Manual Installation on Linux and the Manual ownCloud Upgrade.

The package installation is for single-server setups only.

Changes in the Linux Distribution Packages 9

Linux distribution packages (from Open Build Service) have been divided into multiple packages: owncloud, owncloud-deps and owncloud-files.

  • owncloud-files (recommended): This package installs only ownCloud. It does not install Apache, a database, or any PHP dependencies.
  • owncloud: This package installs ownCloud, complete with all dependencies.
  • owncloud-deps: This packages install only ownCloud’s dependencies (Apache, PHP, and MySQL). It is not intended to be installed by itself, but rather is pulled in by the owncloud metapackage.

Note

The owncloud package is a meta-package that only installs ownCloud’s dependencies, such as Apache, and the required PHP modules. We don’t recommend it, as it can be harmful, such as in environments where several applications are hosted simultaneously. As such we recommend using owncloud-files (which actually installs ownCloud) and further recommend administrators manage both the environment as well as ownCloud’s dependencies.

Note

owncloud-files is available for the following distributions, but not owncloud-deps.

You will have to install your own LAMP stack first. This allows you to create your own custom LAMP stack without dependency conflicts with the ownCloud package. Browse http://download.owncloud.org/download/repositories/9.1/owncloud/ to find the owncloud-files package for your distro:

  • Ubuntu 14.04, 16.04
  • Debian 7, 8
  • RHEL 6, 7
  • CentOS 6 SCL, 7
  • SLES 12, 12 SP1
  • openSUSE 13.2, Leap 42.1

ownCloud packages with dependencies are available for the following Linux distributions:

  • Ubuntu 14.04 & 16.04
  • Debian 7 & 8
  • RHEL 6 & 7
  • CentOS 7.2 & 7.3
  • SLES 11SP4 & 12SP2
  • openSUSE Leap 42.2 & 42.3

Repositories for Fedora, openSUSE Tumbleweed and Ubuntu 15.04 were dropped. If you use Fedora, use the tar archive with your own LAMP stack. openSUSE users can rely on LEAP packages for Tumbleweed.

Follow the instructions on the download page to install ownCloud. Then run the Installation Wizard to complete your installation. (see The Installation Wizard).

Warning

Do not move the folders provided by these packages after the installation, as this will break updates.

See the System Requirements for the recommended ownCloud setup and supported platforms.

Repositories

You may use either of the following repositories for ownCloud, substituting <version> for the version of ownCloud that you want to install, or stable:

  • https://download.owncloud.org/download/repositories/<version>/owncloud/
  • If you use stable, you never have to change it, as it always tracks the current stable ownCloud version through all major releases. Major releases are indicated by the second number, so 8.0, 8.1, 8.2, and 9.0 were all major releases.
  • If you wish to track a specific major release, such as 9.0 or 9.1, then substitute <version> with that instead. Doing so avoids you accidentally upgrading to the next major release before you’re ready.

Installing ownCloud Enterprise Edition

See Installing & Upgrading ownCloud Enterprise Edition for instructions on installing ownCloud Enterprise edition.

Downgrading

Downgrading is not supported and risks corrupting your data! If you want to revert to an older ownCloud version, install it from scratch 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 ownCloud forums to see if your issue can be resolved without downgrading.

Additional Installation Guides and Notes

See The Installation Wizard for important steps such as choosing the best database and setting correct directory permissions.

See SELinux Configuration for a suggested configuration for SELinux-enabled distributions such as Fedora and CentOS.

If your distribution is not listed, your Linux distribution may maintain its own ownCloud packages, or you may prefer to install from source code (see Manual Installation on Linux).

Archlinux: The current stable version is in the official community repository, and more packages are in the Arch User Repository.

Mageia: The Mageia Wiki has a good page on installing ownCloud from the Mageia software repository.

Running ownCloud in a subdirectory: If you’re running ownCloud in a subdirectory and want to use CalDAV or CardDAV clients make sure you have configured the correct Service discovery URLs.

Note for MySQL/MariaDB environments: Please refer to MySQL / MariaDB with Binary Logging Enabled on how to correctly configure your environment if you have binary logging enabled.