# How to configure NextCloudPi

**URL:** <https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310>\
**Category:** NextcloudPi Documentation\
**Tags:** 2-configure, ncp\
**Created:** [October 29, 2021, 11:32pm UTC](https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310 "2021-10-29T23:32:35Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![ncpbot](https://help.nextcloud.com/user_avatar/help.nextcloud.com/ncpbot/32/43429_2.png) [@ncpbot](https://help.nextcloud.com/u/ncpbot)\
**Post date:** [October 29, 2021, 11:32pm UTC](https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310/1 "2021-10-29T23:32:35Z")

</div>

![nextcloudpidocs_banner_short_V3](https://help.nextcloud.com/uploads/default/original/3X/7/c/7c4ca640751c3a223666a44aec991abd85dc7279.jpeg)

 

## Configuration directly after Activation

Directly after the initial setup including Activation of Nextcloud / NextcloudPi there is only the **WebUI** available for configuration.

### WebUI

If you want to configure NextcloudPi with the WebUI:

1. Open a web browser.

2. Write in the URL [https://nextcloudpi.local:4443](https://nextcloudpi.local:4443) or the IP-address of the Raspberry Pi device in your browser plus adding port :4443

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.](https://user-images.githubusercontent.com/14947634/34748770-10015646-f596-11e7-8f56-4e33cf5c9260.png)  
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](https://help.nextcloud.com/t/how-to-configure-lets-encrypt-with-closed-ports-80-and-443/126375/3) that your browser will recognize.

1. You will be asked for the NCP-password, that’s been generated during initial Activation.

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

From here you can configure everything that you need.

- See the [configuration reference](https://help.nextcloud.com/t/configuration-reference-draft-2/126011) for an explanation of all the options.

- Follow these [steps to access from outside](https://help.nextcloud.com/t/how-to-access-from-outside-your-network/126311).

- Follow these [steps to host your data in a USB drive](https://help.nextcloud.com/t/how-to-configure-an-external-usb-drive-with-nextcloudpi/126376).

- Change password of NCP-user / WebUI using `nc-passwd`

## TUI - Terminal user interface

To be able to use the terminal user interface (TUI) SSH has to be activated first. SSH-Terminal-access can be activated from WebUI (read [https://help.nextcloud.com/t/how-to-enable-ssh-using-ncp-config-or-ncp-web/126317](https://help.nextcloud.com/t/how-to-enable-ssh-using-ncp-config-or-ncp-web/126317). During SSH-Activation you can set password for user as well!

After SSH-Activation you can use in addition to the WebUI also a terminal user interface (TUI) either via SSH or via terminal-logon with plugged in keyboard/display.

Once you are logged on to NextcloudPi shell you can run the command  
`sudo ncp-config` to open the TUI.

The back-end of TUI is the same as the WebUI: All options are accessible in either UI.

_We hope this doc was helpful, if you encounter any issues please reach out to the [community](https://help.nextcloud.com/t/forum-github-or-chat-which-to-use-when/126318)._  
_These docs are written by volunteers, please consider becoming one of them.  
Contact the wiki team at [Matrix](https://matrix.to/#/#nextcloudpi:matrix.org) or [Telegram](https://t.me/NCP_Wiki_Team)_

---

<div class="post-metadata">

**Author:** ![janvlug](https://help.nextcloud.com/user_avatar/help.nextcloud.com/janvlug/32/7652_2.png) [@janvlug](https://help.nextcloud.com/u/janvlug)\
**Post date:** [November 25, 2022, 8:32pm UTC](https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310/3 "2022-11-25T20:32:25Z")

</div>

I had to go to [https://nextcloudpi.local](https://nextcloudpi.local) after first install (so not the port number 4443 as stated in the text)

---

<div class="post-metadata">

**Author:** ![CarnivioN](https://help.nextcloud.com/letter_avatar/carnivion/32/6_22734026db12803ebb3e059622ac3534.png) [@CarnivioN](https://help.nextcloud.com/u/CarnivioN)\
**Post date:** [June 25, 2023, 1:33am UTC](https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310/4 "2023-06-25T01:33:48Z")

</div>

The URL for the doc about [get a certificate from Let’s Encrypt](https://help.nextcloud.com/t/how-to-configure-lets-encrypt-with-closed-ports-80-and-443/126375/3) is broken. Is there any other tutorial on how to fix the webui not secure issue(and maybe also the dns problem)? Thank you, please!

---

<div class="post-metadata">

**Author:** ![anon75456558](https://help.nextcloud.com/letter_avatar/anon75456558/32/6_22734026db12803ebb3e059622ac3534.png) [@anon75456558](https://help.nextcloud.com/u/anon75456558)\
**Post date:** [June 25, 2023, 2:19am UTC](https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310/5 "2023-06-25T02:19:32Z")

</div>

Hmm, restored for the moment so you can use it. Looks like it was supposed to be re-written.

---

<div class="post-metadata">

**Author:** ![Name\_Surname](https://help.nextcloud.com/user_avatar/help.nextcloud.com/name_surname/32/56515_2.png) [@Name\_Surname](https://help.nextcloud.com/u/Name_Surname)\
**Post date:** [August 28, 2024, 9:04am UTC](https://help.nextcloud.com/t/how-to-configure-nextcloudpi/126310/6 "2024-08-28T09:04:57Z")

</div>

tldr wifi headless setup on armbian bookworm:  
/etc/netplan/01-wifi.yaml

```auto
network:
  version: 2
  renderer: networkd
  wifis:
    wlan0:
      dhcp4: true
      access-points:
        "YOUR_NETWORK_SSID":
          password: "WIFI_PASSWORD"

```

just mount root partition after you wrote the image and put this file there.

it was really hard to find out “how to setup wifi after you wrote the image to your flash drive” after nextcloudpi migration to armbian.  
raspberry imager doesn’t work with the prebuilt image from github releases (rpi4 in my case).  
wpa\_supplicant.conf doesn’t work as on raspbian, but netplan successfully configured it.
