Owncloud is open-source file sync, share, and content collaboration software that lets teams work on data easily from anywhere, on any device. It provides access to your data through a web interface while providing a platform to view, sync and share across devices easily.

How to install and configure


Read this page for instructions on installing and configuring an Owncloud server as an administrator.

Chapter 1. Requirements for Installing Owncloud

Before installing Owncloud, review the following supported system requirements.

1.1 Prerequisites

  • Verify if the following options meet the minimum requirement for Owncloud.

1.2 System requirements checklist for installing Owncloud

Requirements Options
Operating System Ubuntu 16.04 and 18.04
  Debian 7, 8, and 9
  SUSE Linux Enterprise Server 12 with SP1, SP2, and SP3
  Red Hat Enterprise Linux 6.9, 7.3, 7.4, and 7.5
  Fedora 27, 28, and 29
  openSUSE Leap 42.3 and 15
Database MySQL or MariaDB 5.5+
  Oracle 11g
  PostgreSQL 9
  openSUSE Leap 42.3 and 15
  Web server
  Apache 2.4 with prefork and mod_php
PHP Runtime 5.6, 7.0, 7.1, and 7.2
Mobile iOS 9.0+
  Android 4.0+
Web Browser Edge (current version on Windows 10)
  IE11+ (except Compatibility Mode)
  Firefox 57+ or 52 ESR
  Chrome 66+
  Safari 10+
Desktop Windows 7+
  Mac OS X 10.7+ (64-bit only)
  CentOS 6 & 7 (64-bit only)
  Debian 8.0 & 9.0
  Fedora 27 & 28
  Ubuntu 16.04 & 18.04
  openSUSE Leap 42.2 & 42.3
Hypervisors Hyper-V
  VMware ESX
Client Versions Desktop Client 2.3.3
  iOS App
  Android App

Memory Requirements

Memory requirements for running an Owncloud server are greatly variable, depending on the numbers of users and files, and volume of the server activity. Owncloud officially requires a minimum of 128MB RAM. But, it is recommended a minimum of 512MB RAM.

Database Requirements

The following are currently required if you’re running Owncloud together with a MySQL or MariaDB database:

Chapter 2. Installing and Configuring Owncloud Using Docker

This chapter describes how to install and configure the Owncloud server using Docker Compose.

The process consists of configuring the environment, creating the containers, stopping the containers, connecting users to the Owncloud server using the server’s IP address and port 8080 and logging in to the Owncloud server.


  • The host machine must be able to connect to the Internet.
  • Ensure the default port for HTTP, 8080, is accessible.
  • Docker is installed and Docker daemon is running.


If you want to run Docker without root privileges, see Run the Docker daemon as a non-root user (Rootless mode).


1. Verify that Docker is installed.

$ sudo docker info


Context:    default
Debug Mode: false
 app: Docker App (Docker Inc., v0.9.1-beta3)
 buildx: Build with BuildKit (Docker Inc., v0.5.1-docker)
 scan: Docker Scan (Docker Inc., v0.6.0)

Containers: 4
Running: 4
Paused: 0
Stopped: 0
Images: 21
Server Version: 20.10.5
Storage Driver: overlay2

If you get the output, skip the next step. If you see docker: command not found, continue to the next step Install Docker.

2. Install Docker.

3. Create a new project directory.

$ sudo mkdir owncloud-docker-server

4. Change the current directory.

$ cd owncloud-docker-server


Go to the directory where your .yaml and .env files are located to be able to run docker-compose commands.

5. Copy docker-compose.yml from the GitHub repository.

$ wget https://raw.githubusercontent.com/owncloud/docs/master/modules/admin_manual/examples/installation/docker/docker-compose.yml

6. Create the environment configuration file. The configuration exposes port 8080, to allow HTTP connections. It uses separate MariaDB and Redis containers and mounts the data and MySQL data directories on the host for persistent storage.

$ cat << EOF > .env


ADMIN_USERNAME and ADMIN_PASSWORD do not change between deploys even if the values in the .env file are changed. Do docker volume prune to change those values. Which deletesall your data.

The following instructions assume you install locally. For remote access, the value of OWNCLOUD_DOMAIN must be adapted.

7. Build and start the container

$ sudo docker-compose up -d


$ docker-compose up -d          
Docker Compose is now in the Docker CLI, try `docker compose up`

Creating owncloud_mariadb ... done
Creating owncloud_redis   ... done
Creating owncloud_server  ... done

8. Check that all the containers have successfully started.


docker-compose ps   
      Name                    Command                  State               Ports         
owncloud_mariadb   docker-entrypoint.sh --max ...   Up (healthy)   3306/tcp              
owncloud_redis     docker-entrypoint.sh --dat ...   Up (healthy)   6379/tcp              
owncloud_server    /usr/bin/entrypoint /usr/b ...   Up (healthy)>8080/tcp

2.1 Stop the Containers

1. You can stop the containers using docker-compose command. Run the command below.

$ sudo docker-compose stop


$ sudo docker-compose stop     
Stopping owncloud_server  ... done
Stopping owncloud_mariadb ... done
Stopping owncloud_redis   ... done

2. Stop and remove containers, along with the related networks, images, and volumes. Run the command below.

$ sudo docker-compose down --rmi all --volumes


$ sudo docker-compose down --rmi all --volumes
Removing owncloud_server  ... done
Removing owncloud_mariadb ... done
Removing owncloud_redis   ... done
Removing network owncloud-docker-server_default
Removing volume owncloud-docker-server_files
Removing volume owncloud-docker-server_mysql
Removing volume owncloud-docker-server_redis
Removing image mariadb:10.5
Removing image redis:6
Removing image owncloud/server:10.7

3. Verify that containers are removed.

$ sudo docker-compose ps


$ sudo docker-compose ps
Name   Command   State   Ports

Chapter 3. Installing and Configuring Owncloud Server using Linux Package Manager

This chapter consists of instructions on how to install LAMP, download and install Owncloud source packages, setup MariaDB and configure Owncloud.


1. Install LAMP ( Linux, Apache, MariaDB, and PHP ) server.
2. Update the Package Manager for package installation, see Package manager.
3. Download and install OwnCloud, see Download.
4. Setup MariaDB for OwnCloud.
5. Log in to the Owncloud server. For more details, see the next chapter Log in to Owncloud.

Chapter 4. Log in to Owncloud

You can view the Owncloud user interface by logging into Owncloud.


  • The Owncloud is installed and configured.
  • A running browser to run the URL.


1. Open the URL http://localhost:8080 in a web browser.

Figure 2.3.1

2. Enter the Username admin and its Password.

Figure 2.3.2

3. Click the arrow to log into the Owncloud User Interface.

Figure 2.3.3

Chapter 5. Adding a User Account as an Administrator

This chapter describes how to add a user account to the Owncloud user interface.


  • The Owncloud user interface is accessible.
  • Being logged into the Owncloud user interface as an administrator.


1. Enter the Username and Password to log into the Owncloud user interface.

Figure 4.1

2. In the top right corner, click admin. Click Users from the dropdown list.

Figure 4.2

3. Enter the username and email.

Figure 4.3

4. Click the Create button.

Figure 4.4

Chapter 6. Installing and Connecting to Owncloud Server Using a Desktop Client.

This chapter describes steps to install and connect to the Owncloud server using a desktop client as a user.


  • The Desktop Application must be downloaded. For details, see Download desktop app.
  • You have the URL of the Owncloud server.


1. Open the desktop application in your system. The installation wizard takes you step-by-step through configuration options and account setup.

2. Click the Continue button.

Figure 5.2

3. Click the Install button.

Figure 5.1

4. Enter the URL for the Owncloud server in the space in front of the Server Address.

5. Click the Next button.

Figure 5.3

6. Once the installation process is completed, enter the Username and Password.

Figure 5.4

7. You can sync all of your files on the Owncloud server or select individual folders on the Local Folder option. The default local sync folder is ownCloud, in your home directory. You can change the location of the local sync folder.

Figure 5.5

8. Click on the Connect button. You will see that Owncloud is synchronizing files with the local folder.

Figure 5.6