How to Install Nextcloud on a VPS: Step-by-Step

This guide walks you through installing Nextcloud on your own VPS (Virtual Private Server), giving you a self-hosted cloud storage solution with file sync, sharing, and collaboration tools. You’ll need a VPS with Ubuntu 22.04 or 24.04, a domain name (or you can use the server’s IP address), and basic comfort with the command line. By the end, you’ll have a working Nextcloud instance accessible over HTTPS.

What You’ll Need

• A VPS with at least 2 GB RAM, 20 GB disk space, and a fresh installation of Ubuntu 22.04 or 24.04.
• Root or sudo access to the server.
• A domain name pointing to your server’s IP address (recommended for SSL).
• An email address for the Let’s Encrypt SSL certificate (if using a domain).
• SSH client (like PuTTY on Windows or Terminal on macOS/Linux).

Step-by-Step

1. Connect to your VPS – Open your SSH client and log in as root or a user with sudo privileges: ssh user@your_server_ip
2. Update the system – Run sudo apt update && sudo apt upgrade -y to update package lists and upgrade existing packages. Reboot if a kernel update was applied: sudo reboot
3. Install required packages – Install Apache, MariaDB, PHP, and necessary PHP extensions: sudo apt install apache2 mariadb-server libapache2-mod-php php php-gd php-mysql php-curl php-mbstring php-intl php-gmp php-bcmath php-xml php-imagick php-zip -y
4. Configure MariaDB – Run sudo mysql_secure_installation and follow the prompts to set a root password and remove insecure defaults. Then create a database and user for Nextcloud: sudo mysql -u root -p and run:

   CREATE DATABASE nextcloud;
   CREATE USER 'nextcloud'@'localhost' IDENTIFIED BY 'strong_password_here';
   GRANT ALL PRIVILEGES ON nextcloud.* TO 'nextcloud'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

5. Download Nextcloud – Get the latest Nextcloud archive and extract it to the web root: cd /tmp && wget https://download.nextcloud.com/server/releases/latest.zip (if wget is missing, install it with sudo apt install wget unzip). Then unzip: sudo unzip latest.zip -d /var/www/
6. Set file permissions – Give the web server ownership: sudo chown -R www-data:www-data /var/www/nextcloud
7. Configure Apache – Create a virtual host file: sudo nano /etc/apache2/sites-available/nextcloud.conf and add:

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

   Replace your-domain.com with your actual domain or IP. Enable the site and required modules: sudo a2ensite nextcloud && sudo a2enmod rewrite headers env dir mime then reload Apache: sudo systemctl reload apache2

8. Enable HTTPS with Let’s Encrypt – Install Certbot: sudo apt install certbot python3-certbot-apache -y then run sudo certbot --apache -d your-domain.com and follow the prompts. If you’re using an IP address, skip this step and use HTTP (not recommended for production).
9. Complete the web installer – Open your browser and go to https://your-domain.com (or http://your-server-ip). Enter an admin username and password, then click “Storage & databaseâ€� and choose MySQL/MariaDB. Enter the database name, user, password, and host (localhost). Click “Finish setupâ€�.
10. Set up a cron job – Nextcloud needs a background job for tasks like file scanning. Add a cron entry: sudo crontab -u www-data -e and add this line: */5 * * * * php -f /var/www/nextcloud/cron.php
11. Increase PHP memory limit – Edit sudo nano /etc/php/8.1/apache2/php.ini (adjust version if needed) and set memory_limit = 512M. Restart Apache: sudo systemctl restart apache2
12. Verify the installation – Log in to your Nextcloud, go to Settings → Overview, and check for any warnings. Ensure the “Background jobs� section shows “Cron�.

Common Mistakes

• Skipping the database setup – Using SQLite instead of MariaDB for production will cause performance issues. Always create a proper MySQL/MariaDB database.
• Wrong file permissions – If the web server can’t write to the Nextcloud directory, you’ll see errors. Make sure www-data owns the folder.
• Not enabling Apache modules – Missing mod_rewrite causes 404 errors on pretty URLs. Double-check that you ran a2enmod rewrite.
• Using HTTP without SSL – Nextcloud may function, but it’s insecure and some features (like external storage) will be blocked. Always use HTTPS.
• Ignoring PHP version requirements – Nextcloud requires PHP 8.0 or newer. Check with php -v and upgrade if needed.

Tips

• Use a dedicated domain and set up a DNS A record before starting to avoid reconfiguring later.
• For better performance, install Redis for caching: sudo apt install redis-server php-redis and add 'memcache.local' => '\OC\Memcache\Redis' to config.php.
• Back up your /var/www/nextcloud/config/config.php and the database regularly. Use mysqldump for the database.
• If you plan to use the server for many users, consider increasing RAM to 4 GB or more.
• Keep your Nextcloud updated by following the official upgrade instructions; don’t skip major versions.

Troubleshooting

• Installation page shows 502 Bad Gateway – This usually means Apache isn’t running or the virtual host is misconfigured. Check sudo systemctl status apache2 and review /var/log/apache2/error.log.
• “Can’t write into config directoryâ€� – Run sudo chown -R www-data:www-data /var/www/nextcloud and try again.
• Database connection error – Verify the database name, user, and password. Test with mysql -u nextcloud -p from the server.
• HTTPS certificate fails – Ensure your domain resolves to the server’s IP and that port 80 is open in your firewall (if any). Use sudo ufw allow 80,443/tcp if you have UFW enabled.
• White screen after login – Clear the browser cache and check the PHP error log at /var/log/apache2/error.log. Also verify the memory_limit is set to at least 256M.
• Nextcloud says “Your data directory is not writableâ€� – The data directory (default /var/www/nextcloud/data) must be owned by www-data. Run sudo chown -R www-data:www-data /var/www/nextcloud/data.

Frequently Asked Questions

Can I install Nextcloud on a VPS with 1 GB RAM?

Technically yes, but performance will be poor. Nextcloud recommends at least 2 GB RAM, especially if you have multiple users or use collaborative editing.

Do I need a domain name?

No, you can use the server’s IP address, but you won’t be able to get a free SSL certificate from Let’s Encrypt. For personal testing, IP works; for production, use a domain.

How do I update Nextcloud to a new version?

Back up your config and data, then download the new release, replace the files, and run the upgrade script via the web interface or occ upgrade command. Always check the official documentation for version-specific steps.

Can I use Nginx instead of Apache?

Yes, Nextcloud works with Nginx. The steps differ slightly, but the core installation (PHP, database, files) remains the same. Refer to the official Nextcloud admin manual for Nginx configuration.

How do I access Nextcloud from my mobile device?

Install the Nextcloud mobile app from the App Store or Google Play, enter your server URL and credentials, and you can sync files and photos.

What if I forget my admin password?

You can reset it from the command line: sudo -u www-data php /var/www/nextcloud/occ user:resetpassword admin. This will prompt you to set a new password.

Related

• Mini LED vs OLED for Gaming: HDR, Response, Burn-In
• Show Hidden Files Mac Finder: 3 Ways
• Set Time Limit App iPhone iOS 12