You can configure the NextCloudPi instance from the terminal user interface (TUI) or from the web user interface (WebUI).
:: Note ::
The back-end is the same, all options can be accessible in either UI.
EDIT :: The WebUI has some nice additional features in more current versions
To access the terminal, you need to have ssh enabled on your Raspberry Pi.
Alternatively, you can plug in a keyboard and HDMI screen to access the terminal.
Connect keyboard and HDMI screen.
Turn on Raspberry Pi with NextCloudPi SD card image.
Login with user
sudo raspi-configand enable SSH in
sudo ncp-configand use
nc-wifito connect to your WLAN, remember you need to set the correct country and localisation in
sudo raspi-configfirst for your WiFi to work.
Open a terminal.
Connect to your Raspberry Pi with
ssh. You can do that using the command
ssh pi@ip-address, where “ip-address” is the Pi’s local IP address
Enter the password for pi:
raspberryor for root on Armbian:
Install Putty from its website
Run Putty and write the IP address of your Raspberry Pi in the “Host Name” box.
Select “SSH” from the “Connection type” buttons. The port number should now change to “22”.
Click “Open” on the bottom right.
You now have connected to the NextCloudPi Shell. You can run the command
sudo ncp-config to open the TUI.
If you want to configure NextCloudPi with the WebUI:
Open a web browser.
Write in the URL https://nextcloudpi.local:4443, or the IP-address of the Raspberry Pi device.
There should be an message saying that the address you are visiting is not secure.
Accept the self-signed certificate, do this by clicking advanced on the warning page and then clicking to add exception as shown in the image below
This happens because by default browsers do not recognize self-signed certificates as secure (since it was signed by yourself and not someone else authenticating you)
Later you can get a certificate from Let’s Encrypt that your browser will recognize.
- You will be asked for a password. On older installations it is the same one as the
piuser, so it will be by default user
raspberry. On newer installations this changed to user
ncpand a generated passord password . You can change this password after initial configuration using the
After this you should be able to see the Web Panel.
From here you can configure everything that you need.
See the configuration reference for an explanation of all the options.
Follow these steps to access from outside.
Follow these steps to host your data in a USB drive.
Follow this tutorial to sync your NextCloudPi Files, Contacts, Tasks and Calendars with your Android phone.
We hope this doc was helpful, if you encounter any issues please reach out to the community.
These docs are written by volunteers, please consider becoming one of them.
Contact the wiki team at Matrix or Telegram