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.
- Verify if the following options meet the minimum requirement for Owncloud.
1.2 System requirements checklist for installing Owncloud
|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+|
|openSUSE Leap 42.3 and 15|
|Apache 2.4 with prefork and mod_php|
|PHP Runtime||5.6, 7.0, 7.1, and 7.2|
|Web Browser||Edge (current version on Windows 10)|
|IE11+ (except Compatibility Mode)|
|Firefox 57+ or 52 ESR|
|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|
|Client Versions||Desktop Client 2.3.3|
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.
The following are currently required if you’re running Owncloud together with a MySQL or MariaDB database:
BINLOG_FORMAT = MIXED or BINLOG_FORMAT = ROWconfigured Binary Logging, see MySQL / MariaDB with Binary Logging Enabled.
InnoDB storage engine, see MySQL / MariaDB storage engine.
READ COMMITEDtransaction isolation level, see MySQL / MariaDB READ COMMITED transaction isolation level.
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
Client: Context: default Debug Mode: false Plugins: 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) Server: 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
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 OWNCLOUD_VERSION=10.7 OWNCLOUD_DOMAIN=localhost:8080 ADMIN_USERNAME=admin ADMIN_PASSWORD=admin HTTP_PORT=8080 EOF
ADMIN_PASSWORDdo not change between deploys even if the values in the .env file are changed. Do
docker volume pruneto change those values. Which deletesall your data.
The following instructions assume you install locally. For remote access, the value of
OWNCLOUD_DOMAINmust 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) 0.0.0.0:8080->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.
2. Enter the Username admin and its Password.
3. Click the arrow to log into the Owncloud User Interface.
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.
2. In the top right corner, click admin. Click Users from the dropdown list.
3. Enter the username and email.
4. Click the Create button.
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.
3. Click the Install button.
4. Enter the URL for the Owncloud server in the space in front of the Server Address.
5. Click the Next button.
6. Once the installation process is completed, enter the Username and Password.
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.
8. Click on the Connect button. You will see that Owncloud is synchronizing files with the local folder.