How to configure NextCloudPi

Choose an User Interface

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
(v1.24.2 April14th2020)


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.

Raspberry Pi

  1. Connect keyboard and HDMI screen.

  2. Turn on Raspberry Pi with NextCloudPi SD card image.

  3. Login with user pi and password raspberry.

  4. (optional) type sudo raspi-config and enable SSH in Interfacing Options.

  5. (optional) type sudo ncp-config and use nc-wifi to connect to your WLAN, remember you need to set the correct country and localisation in sudo raspi-config first for your WiFi to work.

Linux / Mac

  1. Open a terminal.

  2. 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
    or use
    ssh pi@nextcloudpi.local

  3. Enter the password for pi: raspberry or for root on Armbian: 1234


  1. Install Putty from its website

  2. Run Putty and write the IP address of your Raspberry Pi in the “Host Name” box.

  3. Select “SSH” from the “Connection type” buttons. The port number should now change to “22”.

  4. Click “Open” on the bottom right.

  5. Enter password raspberry

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:

  1. Open a web browser.

  2. Write in the URL https://nextcloudpi.local:4443, or the IP-address of the Raspberry Pi device.

  3. 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
    Accept Signed NCP certificate.

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.

  1. You will be asked for a password. On older installations it is the same one as the pi user, so it will be by default user pi, password raspberry. On newer installations this changed to user ncp and a generated passord password . You can change this password after initial configuration using the nc-passwd dialog.

After this you should be able to see the Web Panel.

From here you can configure everything that you need.

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

this link is not working anymore.