sodcalculator

10 Tech How-To

How to Install ownCloud on Linux (Step-by-Step)

Guide 10-48411 · Updated · Step by step

This guide walks you through installing ownCloud on a Linux server, giving you a self-hosted file sync and sharing platform. You’ll set up a LAMP stack (Linux, Apache, MySQL/MariaDB, PHP), download ownCloud, configure the web server, and complete the installation via a web browser. By the end, you’ll have a fully functional ownCloud instance accessible over your network.

What You’ll Need

  • A Linux server (Ubuntu 22.04/24.04, Debian 12, or similar) with root or sudo access.
  • A domain name or IP address pointing to your server (optional but recommended for production).
  • An SSL certificate (Let’s Encrypt or self-signed) for secure HTTPS access (recommended).
  • At least 2 GB of RAM and 10 GB of free disk space.

Step-by-Step

  1. Update your system

    Log in to your server via SSH and update the package lists and existing packages:

    sudo apt update && sudo apt upgrade -y
  2. Install Apache, MariaDB, and PHP

    ownCloud requires a web server, a database, and PHP. Install them with:

    sudo apt install apache2 mariadb-server libapache2-mod-php php-gd php-mysql php-curl php-mbstring php-intl php-gmp php-bcmath php-xml php-imagick php-zip
  3. Configure MariaDB

    Secure the database server and create a database and user for ownCloud.

    sudo mysql_secure_installation

    Follow the prompts to set a root password and remove insecure defaults. Then create the ownCloud database:

    sudo mysql -u root -p

    In the MySQL prompt, run:

    CREATE DATABASE owncloud;
    CREATE USER 'owncloud'@'localhost' IDENTIFIED BY 'your-strong-password';
    GRANT ALL PRIVILEGES ON owncloud.* TO 'owncloud'@'localhost';
    FLUSH PRIVILEGES;
    EXIT;
  4. Download ownCloud

    Go to the official ownCloud download page to get the latest tarball URL, then download and extract it to the web root:

    cd /tmp
    wget https://download.owncloud.com/download/owncloud-x.y.z.tar.bz2
    tar -xjf owncloud-x.y.z.tar.bz2
    sudo mv owncloud /var/www/html/

    Replace x.y.z with the actual version number.

  5. Set file permissions

    ownCloud needs to write to certain directories. Set the correct ownership:

    sudo chown -R www-data:www-data /var/www/html/owncloud
  6. Configure Apache

    Create a virtual host configuration for ownCloud:

    sudo nano /etc/apache2/sites-available/owncloud.conf

    Add the following (adjust ServerName to your domain or IP):

    <VirtualHost *:80>
        DocumentRoot /var/www/html/owncloud
        ServerName your-domain.com
    
        <Directory /var/www/html/owncloud>
            Options FollowSymlinks
            AllowOverride All
            Require all granted
        </Directory>
    
        ErrorLog ${APACHE_LOG_DIR}/owncloud_error.log
        CustomLog ${APACHE_LOG_DIR}/owncloud_access.log combined
    </VirtualHost>

    Enable the site and required Apache modules:

    sudo a2ensite owncloud
    sudo a2enmod rewrite headers env dir mime
    sudo systemctl restart apache2
  7. Run the web installer

    Open your browser and go to http://your-server-ip/owncloud. You’ll see the ownCloud setup page. Enter:

    • An admin username and password.
    • Data folder (default is fine, e.g., /var/www/html/owncloud/data).
    • Database: choose MySQL/MariaDB and enter the database name, user, and password you created.

    Click Finish setup. ownCloud will create the necessary tables and finish the installation.

  8. Secure with HTTPS (recommended)

    Use Let’s Encrypt to get a free SSL certificate:

    sudo apt install certbot python3-certbot-apache
    sudo certbot --apache

    Follow the prompts to enable HTTPS for your domain.

  9. Set up a cron job for background tasks

    ownCloud uses cron for scheduled tasks like file scanning. Add a cron entry:

    sudo crontab -u www-data -e

    Add this line:

    */5  *  *  *  * php -f /var/www/html/owncloud/cron.php
  10. Final checks

    Go to http://your-server/owncloud/settings/admin and check the security warnings. Ensure the data directory is not accessible from the web (it should be outside the web root, but the default location is acceptable if you block it via Apache).

Common Mistakes

  • Forgetting to install PHP extensions – ownCloud will show errors if required modules are missing. Double-check that you installed all the packages listed in Step 2.
  • Incorrect file permissions – If Apache can’t write to the config or data directories, you’ll get errors. Ensure the www-data user owns the ownCloud directory.
  • Using the wrong database credentials – Typos in database name, user, or password cause connection failures. Re-check the MySQL commands.
  • Not enabling Apache modules – Without mod_rewrite, pretty URLs may not work and the installer might fail.
  • Placing data folder inside web root – This exposes your data to the public. Move it outside /var/www/html (e.g., to /var/owncloud-data) if possible.

Tips

  • Use a dedicated data directory – Store user files outside the web root for better security. You can set this during the web installer.
  • Enable HTTPS – Always use SSL to encrypt data in transit. Let’s Encrypt is free and easy.
  • Regular backups – Back up the ownCloud config, data directory, and database regularly.
  • Update ownCloud regularly – Keep your installation up-to-date to get security fixes and new features.
  • Use a strong admin password – The admin account has full control, so make it unique and complex.

Troubleshooting

  • Installer shows “Can’t write into config directory” – Run sudo chown -R www-data:www-data /var/www/html/owncloud and try again.
  • Database connection error – Verify that MariaDB is running (sudo systemctl status mariadb) and that the database and user exist with correct privileges.
  • Blank page after installation – Check PHP errors in /var/log/apache2/error.log. Often a missing PHP extension is the cause.
  • OwnCloud says “Data directory is not writable” – Ensure the data folder is owned by www-data and has permissions set to 0770 or similar.
  • HTTPS not working – If you used certbot, make sure the virtual host has the SSL certificate paths correctly set. Check with sudo apache2ctl -t.
  • Slow performance – Enable PHP OPcache and consider using Redis for caching. Also check that cron is running.

Frequently Asked Questions

Can I install ownCloud on any Linux distribution?

Yes, the steps are similar on most distributions, but package names and commands may differ. This guide uses apt, which works on Debian/Ubuntu. For RHEL/Fedora, use dnf/yum.

Do I need a domain name?

No, you can use your server’s IP address. However, a domain is recommended for HTTPS certificates and easier access.

Can I use SQLite instead of MariaDB?

Yes, ownCloud supports SQLite, but it’s not recommended for production or multi-user setups. MySQL/MariaDB is more robust.

How do I update ownCloud after installation?

You can update via the web interface when a new version is available, or manually by downloading the latest tarball and replacing the files (backup first).

Can I move the data directory after installation?

Yes, you can change the data directory in config/config.php by modifying the 'datadirectory' value, then move the folder and set permissions.

How do I access ownCloud from outside my local network?

You’ll need to forward port 80/443 on your router to your server’s IP, and ideally set up a dynamic DNS service if your IP changes.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →