Download the Image for your Hardware
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)
md5sum FILE_PATH
Can be generated in Windows using the Command Prompt & the command
certutil -hashfile MD5
Installing
You can run NextCloudPi from an SD card or from a USB drive.
Option 1: Run from SD card
If your computer has a slot for SD cards, insert the card.
If not, insert the card into an SD card reader, then connect the reader to your computer.
GNU/Linux & macOS
Graphical Interface
-
Download NextCloudPi from Github releases:
-
Double-click the
.tar.bz2
file and click “Extract” -
Click “Show the files”
-
Download Etcher from their website
-
Double-click the
.zip
file -
Double-click the
.AppImage
file -
Click “Select Image” in the Window that just opened. Find your image (the
.img
file) you have just extracted and click “Open”. -
Etcher automatically detects the SD card, but verify that is the one you want the image to be installed on.
-
Click “Flash” in Etcher.
Terminal
-
Open a terminal and run the following commands.
-
Run command
cd $HOME/Downloads
(or any other folder you’ve saved the files to). -
Check the file for corruption (optional).
Run the commandmd5sum NextCloudPi_XX-XX-XX.tar.bz2
and compare it with the hash in filemd5sum
, which you can find in downloads page. -
Replace XX-XX-XX with the version you downloaded and run the command
tar -xvf NextCloudPi_XX-XX-XX.tar.bz2
to extract the image. -
Run command
sudo dd bs=4M if=NextCloudPi_XX-XX-XX.img of=/dev/sdx
, where/dev/sdx
is your sd card name. (For more info look here) -
Run command
sync
.
Windows
-
Install Etcher from their website
-
Install 7-Zip from their website
-
Run 7-Zip manager, find your downloaded .tar.bz2 file, right click and choose “extract here”. Next select the .tar file you just extracted, right click and choose “extract here” again. You should now see an .img file.
-
Run Etcher and click “Select Image”. Find your image (the .img file) you have just extracted and click “Open”.
-
Etcher automatically detects the SD card, but verify that is the one you want the image to be installed on.
-
Click “Flash” in Etcher.
Option 2: Hybrid (/boot partition on SD card, / partition on USB)
- This will limit the media errors that usually happen when running from SD card, but will result in a USB HDD that’s spinning up more often.
After the Option 1 steps you can move the root partition to HD or SSD, on Armbian based images you may install a tool to do this:apt install armbian-config
.
Option 3: Run from USB drive
- If you are using a Raspberry Pi 4, and have updated the bootloader to the latest version, you can simply flash the image to a USB media and boot from it, for a more detailed instruction follow these steps.
:: 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 NextCloudPi on SD or external USB drive with Berryboot
- Follow step by step instructions Wiki/HowTo here
First steps
Startup NextCloudPi first time
Remove the SD card and insert it to the Raspberry Pi. Then connect the Raspberry Pi to your home router with an ethernet cable and power on your Raspberry Pi.
Now you have NextcloudPi almost up and running. Continue with How to access NextCloudPi for Activation
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