Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Jan 20, 2021

English | Traditional Chinese 繁體中文 | Simplified Chinese 简体中文

NextCloudPi chatroom icon forums icon Donate blog

NC Logo

This is the build code for NextCloudPi.

NextCloudPi is a ready to use image for Raspberry Pi, Odroid HC1, rock64 and other boards.

This code also generates the NextCloudPi docker images for all architectures, and includes an installer for any Debian based system.

Find the full documentation at


  • Debian/Raspbian 10 Buster
  • Nextcloud 20.0.8
  • Apache 2.4.25, with HTTP2 enabled
  • PHP 7.3
  • MariaDB 10
  • Redis memory cache
  • ncp-config for easy setup ( RAM logs, USB drive and more )
  • Automatic redirection to HTTPS
  • ACPU PHP cache
  • PHP Zend OPcache enabled with file cache
  • HSTS
  • Cron jobs for Nextcloud
  • Sane configuration defaults
  • Full emoji support
  • Postfix email
  • Secure


  • Setup wizard
  • NextCloudPi Web Panel
  • Wi-Fi ready
  • Ram logs
  • Automatic security updates, activated by default.
  • Let’s Encrypt for trusted HTTPS certificates.
  • Fail2Ban protection against brute force attacks.
  • UFW firewall
  • Dynamic DNS support for
  • Dynamic DNS support for freeDNS
  • Dynamic DNS support for duckDNS
  • Dynamic DNS support for spDYN
  • Dynamic DNS support for Namecheap
  • dnsmasq DNS server with DNS cache
  • ModSecurity Web Application Firewall
  • NFS ready to mount your files over LAN
  • SAMBA ready to share your files with Windows/Mac/Linux
  • USB automount
  • Remote updates
  • Automatic NCP updates
  • Automatic Nextcloud updates
  • Update notifications
  • NextCloud backup and restore
  • NextCloud online installation
  • Format USB drive to BTRFS
  • BTRFS snapshots
  • Automatic BTRFS snapshots
  • BTRFS snapshot auto sync
  • scheduled rsync
  • UPnP automatic port forwarding
  • Security audits with Lynis and Debsecan
  • ZRAM
  • SMART hard drive health monitoring

Extras can be activated and configured using the web interface at HTTPS port 4443


, or from the command line from

sudo ncp-config


Run in docker

docker run -d -p 4443:4443 -p 443:443 -p 80:80 -v ncdata:/data --name nextcloudpi ownyourbits/nextcloudpi $DOMAIN

How to build

Install git, docker, qemu-user-static, chroot and all the usual building tools.

git clone
cd nextcloudpi

, or for an Armbian based board

./ odroidxu4   # supported board code name

In order to generate the Docker images

git clone
cd nextcloudpi
./ x86
./ armhf
./ arm64

NextCloudPi can be installed in any architecture running the latest Debian

Note: this assumes a clean Debian install, and there is no rollback method

# curl -sSL | bash



You can find us in the forums and a Telegram group