# How to install NextCloudPi **URL:** \ **Category:** NextcloudPi Documentation\ **Tags:** 1-getting\_started, installation, ncp\ **Created:** [October 29, 2021, 11:27pm UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308 "2021-10-29T23:27:21Z")\ **Posts on this page:** 6\ **Page:** 1
**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:27pm UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308/1 "2021-10-29T23:27:21Z")
![nextcloudpidocs_banner_short_V3](https://help.nextcloud.com/uploads/default/original/3X/7/c/7c4ca640751c3a223666a44aec991abd85dc7279.jpeg) ## Download the Image for your Hardware [Github releases](https://github.com/nextcloud/nextcloudpi/releases) Please note images are 64 bits currently. If you have 32 bits hardware like rpi2 and lower, the image will not boot. You can still try the curl installer or use the docker version. ## MD5 checksum (to verify the download) From the Terminal (GNU/Linux & macOS) Ex. ```bash # 1) Download the file, in this case NextCloudPi_LXD_arm64_v1.52.0.tar.gz wget -O ./NextCloudPi_LXD_arm64_v1.52.0.tar.gz https://github.com/nextcloud/nextcloudpi/releases/download/v1.52.0/NextCloudPi_LXD_arm64_v1.52.0.tar.gz # Verify the checksum, 2 examples # I) Using a here-doc md5sum --check < checksum # II.2) Then verifying the checksum md5sum --check ./checksum # Output: NextCloudPi_LXD_arm64_v1.52.0.tar.gz: OK ``` A new checksum file can be generated on Windows using the Command Prompt & the command ```shell certutil -hashfile MD5 ``` ## Installing You can run NextcloudPi from a microSD card or directly from a USB HDD/SSD connected via USB-cable if you have a supported device and bootloader. _(Recommended is an SSD with USB3.0 in an enclosure so it has its own power supply)_ See [Raspberry Pi Documentation - Mass-storage boot.](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot) ### Option 1: microSD card 1. Check if your computer has a port for an SD or microSD card, if you have an SD card port you can use an adapter to flash the image to a microSD card. _A microSD slot, due to its size, can easily go unnoticed or be forgotten that it’s there so it doesn’t hurt to check if you’re unsure._ 2. Use a card reader via USB-cable. #### GNU/Linux & macOS ##### Graphical Interface 1. Download NextcloudPi from [GitHub releases](https://github.com/nextcloud/nextcloudpi/releases/): 2. Double-click the downloaded file and then select _“Extract”_ 3. Click _“Show the files”_ 4. Download Etcher from [their website](https://etcher.io/) 4.1. Double-click the `.zip` file 4.2. Double-click the `.AppImage` file 4.3. Click _“Select Image”_ in the Window that just opened, find the extracted `.img` file and click on _“Open”_. 5. Etcher should automatically detect the microSD card, remember to verify it’s the one you want the image to be installed on, all data will be removed on the device you select when flashing to it. 6. Click _“Flash”_ in Etcher. ##### Terminal 1. Open a terminal and run the following commands. 2. Run command `cd $HOME/Downloads` (or any other folder you’ve saved the files to). 3. Check the file for corruption _(optional)_. Run the command `md5sum $ARCHIVE_FILE` where `$ARCHIVE_FILE` is the name of the downloaded archive file including the file-type extension in the name _(.tar.gz, .zip)_, and compare it with the hash in file `md5sum` which you can find on the [releases page](https://github.com/nextcloud/nextcloudpi/releases). 4. Execute `tar -xvf $ARCHIVE_FILE` to extract the image, where `ARCHIVE_FILE` is the filename of the downloaded archive file, including the file-type extension in the name. _(.tar.gz, .zip)_ 5. Run command `sudo dd bs=4M if=NextcloudPi_XX-XX-XX.img of=/dev/sdx`, where `/dev/sdx` is the device mount name of your microSD card, check with `lsblk` or `sudo lsblk`. _([More info](https://www.raspberrypi.org/documentation/installation/installing-images/linux.md))_ 6. Run command `sync`. #### Windows 1. Install Etcher from [their website](https://etcher.io/) 2. Install 7-Zip from [their website](http://www.7-zip.org/) 3. Run 7-Zip manager, find your downloaded file, right click and choose _“Extract here”_, there should now be an `.img` file present. 4. Run Etcher and click on _“Select Image”_. 4.1 Find the `.img` file extracted earlier and click on _“Open”_. 1. Etcher automatically detects the SD card, but verify that is the one you want the image to be installed on. 2. Click _“Flash”_ in Etcher. ### Option 2: Hybrid _(`/boot` partition on microSD card and `/` partition on external USB HDD/SSD)_ This will limit the media errors that usually happen when running from the microSD card, but one downside if using a USB HDD is it will be spinning up more often when the device performs read/write operations, an SSD will be quiet & faster but not as durable over the same long period of time as the HDD. _Something to take into consideration if you’re planning long-term use, as in many years._ After the Option 1 steps you can [move the root partition to HD or SSD](https://www.pragmaticlinux.com/2020/08/move-the-raspberry-pi-root-file-system-to-a-usb-drive/), on Armbian based images you may install a tool to do this: `apt install armbian-config`. ### Option 3: USB HDD/SDD or flash drive See [Raspberry Pi Documentation - Mass-storage boot](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot) - If you are using a Raspberry Pi 4 or any of the supported devices linked above, and have updated the bootloader to the latest version, you can flash the image directly to any USB media (mass-storage like a hdd/ssd or a flash drive) and boot from it. For more detailed instructions see [Raspberry Pi Documentation - Mass-storage boot](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot) and [this post.](https://help.nextcloud.com/t/raspberry-pi-4-booting-from-usb-device-no-microsd/126320) > **:: NOTE ::** > Help needed to explain the required steps on other platforms, if you are taking this path, please consider editing this wiki. ### Option 4: Install using Berryboot to a microSD card or an external USB drive - Follow step by step instructions here: [Berryboot - Install NextcloudPi on an external drive](https://help.nextcloud.com/t/berryboot-install-nextcloudpi-on-an-external-drive-step-by-step/126386) ## First boot 1. Remove the microSD card and insert it into the card reader port of the Raspberry Pi. 2. Connect the Raspberry Pi to your home router with an ethernet cable 3. Connect the Raspberry Pi to power and it should turn on _Or turn it on if you have a switch on the power cable_ Almost up and running now, it can take a while when booting for the first time, continue to the next steps by reading: [How to access NextcloudPi for Activation](https://help.nextcloud.com/t/how-to-access-nextcloudpi/126309) * * * _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)_ ---
**Author:** ![anon75456558](https://help.nextcloud.com/letter_avatar/anon75456558/32/5_5575768a8748004e209b776fc1b2916d.png) [@anon75456558](https://help.nextcloud.com/u/anon75456558)\ **Post date:** [May 7, 2022, 6:37pm UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308/2 "2022-05-07T18:37:28Z")
A post was merged into an existing topic: [About moving the articles](https://help.nextcloud.com/t/about-moving-the-articles/134642/14) ---
**Author:** ![Milch](https://help.nextcloud.com/letter_avatar/milch/32/5_5575768a8748004e209b776fc1b2916d.png) [@Milch](https://help.nextcloud.com/u/Milch)\ **Post date:** [June 28, 2022, 7:11pm UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308/3 "2022-06-28T19:11:22Z")
Hi, the downloadlink is broken. Can you help me to find an image ? ---
**Author:** ![ZendaiOwl](https://help.nextcloud.com/user_avatar/help.nextcloud.com/zendaiowl/32/77706_2.png) [@ZendaiOwl](https://help.nextcloud.com/u/ZendaiOwl)\ **Post date:** [June 29, 2022, 11:54am UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308/4 "2022-06-29T11:54:38Z")
Official images for NCP can now be found in the Github Releases only: > **[Releases · nextcloud/nextcloudpi](https://github.com/nextcloud/nextcloudpi/releases/)** > > 📦 Build code for NextcloudPi: Raspberry Pi, Odroid, Rock64, Docker, curl installer... - nextcloud/nextcloudpi ---
**Author:** ![Milch](https://help.nextcloud.com/letter_avatar/milch/32/5_5575768a8748004e209b776fc1b2916d.png) [@Milch](https://help.nextcloud.com/u/Milch)\ **Post date:** [June 29, 2022, 5:57pm UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308/5 "2022-06-29T17:57:10Z")
Thanks for your help. Please change this > [@ZendaiOwl](#): > > Download NextCloudPi from the [Ownyourbits website](https://ownyourbits.com/nextcloudpi/#download): ---
**Author:** ![ZendaiOwl](https://help.nextcloud.com/user_avatar/help.nextcloud.com/zendaiowl/32/77706_2.png) [@ZendaiOwl](https://help.nextcloud.com/u/ZendaiOwl)\ **Post date:** [July 4, 2022, 1:50pm UTC](https://help.nextcloud.com/t/how-to-install-nextcloudpi/126308/6 "2022-07-04T13:50:26Z")
It’s fixed, feel free to join Telegram or Matrix then you can help out move the articles or fix links in the wiki’s 🙏 > [@ZendaiOwl](#): > > 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)