Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

English | Traditional Chinese ็น้ซ”ไธญๆ–‡ | Simplified Chinese ็ฎ€ไฝ“ไธญๆ–‡

(The translated README pages are not updated at this time)


Telegram icon Matrix icon Docker icon Nextcloud icon

Forum icon

NextcloudPi logo

This is the build code for the NextcloudPi open-source community project.

NextcloudPi is a ready to use image for Virtual Machines, Raspberry Pi, Odroid HC1, Rock64 and other boards. (โ‡’ Downloads)

This code also generates the NextcloudPi Docker image, LXD container & VM, there is an install script for the latest stable Debian based system as well.

Find the documentation at, the documentation is all written by volunteers.

Please reach out in the Matrix or Telegram Wiki group chats if you want to help out to keep them up-to-date and we'll add you to the Wiki Group on the forum.


VM Tests

Docker Tests


VM Tests

Docker Tests


  • Raspberry Pi OS/Debian 11 (Bullseye)
  • Nextcloud
  • Apache, with HTTP2 enabled
  • PHP 8.1
  • MariaDB
  • Redis memory cache
  • ncp-config TUI for easy setup ( RAM logs, USB drive and more )
  • Automatic redirection to HTTPS
  • APCu 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 using

sudo ncp-config


Run in docker

docker run --detach \
           --publish 4443:4443 \
           --publish 443:443 \
           --publish 80:80 \
           --volume ncdata:/data \
           --name nextcloudpi \
           ownyourbits/nextcloudpi $DOMAIN

$DOMAIN can also be the IP-address of the host device if you're accessing it via IP-address in your local home network.

Can also be run with the --init flag for zombie process reaping

docker run --detach \
           --init \
           --publish 4443:4443 \
           --publish 443:443 \
           --publish 80:80 \
           --volume ncdata:/data \
           --name nextcloudpi \
           ownyourbits/nextcloudpi $DOMAIN

It takes a moment to start completely, you can check this with docker logs nextcloudpi until it says Init done.

Run in LXD

# Imports the LXC image, replace the X's with version number
lxc image import "NextcloudPi_LXD_vX.XX.X.tar.gz" --alias "nextcloudpi"

# Launches a container from the image
lxc launch "nextcloudpi" ncp

# Starts the container you've launched from the imported image
lxc start ncp

Run in Proxmox

Use the install script from tteck to install the LXC container on your Proxmox instance

He has multiple helper scripts available for Proxmox on his website, do go have a look if you're using Proxmox. ๐Ÿ‘

Installation: bash -c "$(wget -qLO -"

Default Settings: 2GB RAM - 8GB Storage - 2vCPU

(Check his website if this has changed and we haven't had the time to update it here yet, it's located under: Media - Photo > NextcloudPi LXC)

Thenk you tteck โค๏ธ for making the helper script & letting us use this for Proxmox installations ๐Ÿ™

You can find his GitHub repository with his helper scripts here.

How to build


  • apt-utils
  • apt-transport-https
  • build-essential
  • binfmt-support
  • binutils
  • bzip2
  • ca-certificates
  • chroot
  • cron
  • curl
  • dialog
  • lsb-release
  • jq
  • git
  • psmisc
  • procps
  • wget
  • whiptail
  • qemu
  • qemu-user-static
  • docker (If you're building a Docker image)
  • lxd (If you're building an LXD/LXC container image)

Raspberry Pi IMG

git clone
cd nextcloudpi

Armbian-based board

./ odroidxu4   # supported board code name

In order to build & push the Docker image to your repository, you'll also need to change the username, repo and tags in the script to match your credentials at Docker Hub.

git clone
cd nextcloudpi
build/ x86
build/ armhf
build/ 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 install scripts

This is executed as root as indicated by the #

# curl -sSL | bash

If you're not root you can run it with sudo like so

curl -sSL | sudo bash



Docker Hub

Nextcloud Forum

Nextcloud Forum Support

(Use the Forum for Support questions please, there's a NCP tag available, it will bridge your post to the Matrix and Telegram chats)


You can find us on the Forum, Telegram or Matrix