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. For more info look here.

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`][nc-wifi] to connect to your WLAN.

Linux / Mac

  1. Open a terminal.
  2. Connect to your Raspberry Pi with ssh. You can do that using the command ssh pi@"localIPAdress", where “localIPAdress” (without the quotes) is the Pi’s local IP address.
  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 nextcloudpi-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://”raspberryPiAddress”:4443“, where “raspberryPiAddress” (without quotes) should be replaced with your Raspberry Pi’s IP Address.
  3. There should be an message saying that the address you are visiting is not secure. You should accept the self-signed certificate. You can 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. Later you can get a certificate from Let’s Encrypt that your browser will recognize.
  4. 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. See the configuration reference for an explanation of all the options.

You can follow these steps to access from outside.

You can follow these steps to host your data in a USB drive.

You can follow this tutorial to sync your NextCloudPi Files, Contacts, Tasks and Calendars with your Android phone.