# Getting started with NextCloudPi on Proxmox **URL:** \ **Category:** 📑 How to\ **Tags:** docker, vm, ncp, proxmox\ **Created:** [April 12, 2021, 8:48pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487 "2021-04-12T20:48:33Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [April 12, 2021, 8:48pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/1 "2021-04-12T20:48:33Z")
### **Warning, use this “How to” with caution and at your own risk, it’s a work in progress.** _Latest Update 24.01.2023_ - This should, be a beginner-friendly tutorial on how to get NCP running on Proxmox. - Please give feedback if you have issues. - Thanks in advance for any help & contributions. * * * ## **The goal** 1. **Running NCP on a Proxmox server** (obviously) 2. **Pass through a drive that is used for NCP data only.** 3. **Restore NCP Backup from external USB Drive** * * * # **1. Running NCP on a Proxmox** > **Option 1: Official LXC/LXD NCP image in a CT** > > This option, together with option 4 and 5 seem to be the most resource friendly option. > As of 1. October 2021 @nachoparker [added LXD support.](https://github.com/nextcloud/nextcloudpi/blob/e90bc0223cafc728725bfa8f3551cc7759ec0904/README.md) which is great news, as this will be a NCP with all the functionality, as opposed to the docker image that misses some features. > > **However** , things are more complicated than they seem. To my knowledge, there is no streight forward way to install it in a Proxmox CT (October 2022). > Please head over to [this post](https://help.nextcloud.com/t/making-it-possible-nextcloudpi-lxd-on-proxmox/129476) if you want to make it happen. > **Option 2: Official Curl Installer in Debian 11 VM (Recomennded)** > > Works well and easy. However, the drawback here is, that this is not a BTRFS file system that would allow nc-snapshots (except if you do are doing some manual partitioning or add a separate drive with BTRFS) > > > [See Official NCP Documentation](https://help.nextcloud.com/t/nextcloudpi-vm-on-proxmox/126444) for the more polished and up-to-date guide of this option. > > 1. Download [debian-11.X.X-amd64- **netinst**.iso](https://www.debian.org/distrib/) > 2. upload the debian .iso to your Proxmox Server > 3. Set up the Debian VM in Proxmox and give it the resources you wish. _(min 2GB of RAM but ideally much more. If you want to use a separate physical drive for data (see section 2. below), you don’t need more than 4-8GB of disk space, if not, just give it as much as you need for your data.)_ > 4. Boot into the VM and use the Proxmox shell of the VM to go thorough the installation process. > 5. After the initial installation, ssh as `root` into the VM _(you might need to enable `root login` from the Proxmox shell before you can use ssh ([here is how](https://linuxconfig.org/enable-ssh-root-login-on-debian-linux-server))._ Alternatively, just use the Proxmox shell for the steps below _(note: copy and paste does not work in the virtual VM shell)_ > 6. Install updates: `apt updates && apt upgrade -y` > 7. Install curl: `apt install curl` > 8. Install NCP as root by running: `curl -sSL https://raw.githubusercontent.com/nextcloud/nextcloudpi/master/install.sh | bash` > 9. Access & Activate NCP using the VM’s IP from your browser > **Option 3: Official VM image** > > Using the VM image from NCP **was** the easiest and most straightforward option. > **However, currently the NCP project does not offer a VM image.** > ⚠ **Therefore this option is currently not possible.** > I don’t want to delete the section just yet in case a VM image in provided in the future. > Please check the [NCP Release Page](https://github.com/nextcloud/nextcloudpi/releases) on GitHub to see if one is available. > > 1. Create a new VM on your Proxmox server and chose the option “Do not use any media” in the OS section. > > ![Screenshot 2021-04-12 at 22.31.32](https://help.nextcloud.com/uploads/default/original/3X/0/6/06f24edd5d3e3003307f6ef85cc98916556d098d.png) > > 1. In the main Proxmox terminal > > 2. Close the terminal and in the Proxmox Web interface: > > 3. Access & Activate NCP using the browser > > (2021) The default `user` and `password` of your VM will be: > user: `root` > password: `ownyourbits` or `vagrant` > **Option 4: Official Docker image in a CT or VM** > > Together with option 1 this is resource-friendly (if you use a CT). However, you will miss some features and [Proxmox does not recommend running Docker in CTs but only in VMs](https://forum.proxmox.com/threads/proxmox-7-1-and-docker-lxc-vs-vm.105140/#post-452700). > The installation is, for people used to docker, just like any other docker image there is even a [comprehensive guide in the NCP documentation](https://help.nextcloud.com/t/guide-to-getting-started-with-nextcloudpi-docker-in-2020/93396). But I did not have time to work on this Proxmox specific guide, but you can use [the official Docker Documentation](https://docs.docker.com/engine/install/debian/) to install Docker in a CT or VM and then use the NCP Documentation mentioned above to get the NCP Container up and running, > If you like to write a specific tutorial, you are welcome to contribute! > **Option 5: Unofficial Proxmox Helper Script** > > A project, that is not part of the NCP Project [Proxmox Helper Scripts](https://github.com/tteck/Proxmox) Offers one line scripts to install all kinds of software in CTs. > The script works ([as attested here](https://help.nextcloud.com/t/how-to-move-with-nextcloudpi-from-a-raspberry-pi-to-proxmox/146501)) however, you should check what the script does and not blindly trust it. (If you don’t know how to check the script and feel overwhelmed by such a task, [the Video from DT might help to remove some of the anxiaty](https://odysee.com/@DistroTube:2/warning!-always-read-scripts-before:9) 😉 > > 1. Simply use the Proxmox Shell to run the following script: `bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/ct/nextcloudpi-v4.sh)"` this will create a CT with NCP installed. > 2. Use your browser to access and activate your NCP installation. > > If you are migrating from a RaspberryPi to a Proxmox CT @johndoe0815 [wrote a guide on this](https://help.nextcloud.com/t/how-to-move-with-nextcloudpi-from-a-raspberry-pi-to-proxmox/146501) * * * # **2. Pass through a drive that is used for NCP data to a VM.** In this case, we are going to pass through an entire, physical drive to a VM. _(If you wish to only pass through only part of a drive, as virtual drive commands will be slightly different. Check out [this](https://johnkeen.tech/proxmox-physical-disk-to-vm-only-2-commands/) and [the official Proxmox docs](https://pve.proxmox.com/wiki/Passthrough_Physical_Disk_to_Virtual_Machine_(VM)) If you wish to pass through a drive to a CT the process might be very different. [Maybe here you can get help on that?](https://help.nextcloud.com/t/how-to-move-with-nextcloudpi-from-a-raspberry-pi-to-proxmox/146501))_ > **How to** > > 1. Use the main Proxmox Terminal and type: `ls /dev/disk/by-id/` a list of all your drives, physical and virtual will appear. > > 2. Find the drive you wish to pass through to your VM and copy the full drive name. > > 3. Use this command to add it: `qm set VM-ID-NUMBER -scsi2 /dev/disk/by-id/FULL-DRIVE-NAME` > > 4. Leave the Terminal and navigate to your VM > > 5. In the `Hardware` section you should now see the drive. > > 6. Boot your VM and open it’s Terminal. > > 7. With the `lsblk` command you should see your drive listed. > > 8. Delete all data on the drive you want to use as data drive. > > 9. Create a mountpoint, mount it and set auto-mount # **3. Restore NCP Backup from external USB Drive** _(This section needs some love (work), but here is a summary:)_ > **How to** > > Attach your Backup drive to your Proxmox host and pass it through to your NCP VM. > In the NCP VM mount it, and restore the backup: [How to restore NextcloudPi Backup](https://help.nextcloud.com/t/how-to-restore-nextcloudpi-backup/126312). Credit to @OliverV for helping out. Credit to @johndoe0815 for pointing out about the PVE Helper Script ---
**Author:** ![OliverV](https://help.nextcloud.com/user_avatar/help.nextcloud.com/oliverv/32/5741_2.png) [@OliverV](https://help.nextcloud.com/u/OliverV)\ **Post date:** [April 13, 2021, 6:11am UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/2 "2021-04-13T06:11:47Z")
> [@michuvon](#): > > So I would create a VM without using a media? Yes, you add the drive later. In terminal: - cd /var/lib/vz/images/ - wget [https://ownyourbits.com/downloads/NextCloudPi\_VM\_11-30-20/NextCloudPi\_VM\_11-30-20.tar.bz2](https://ownyourbits.com/downloads/NextCloudPi_VM_11-30-20/NextCloudPi_VM_11-30-20.tar.bz2) - tar -xf NextCloudPi\_VM\_11-30-20.tar.bz2 - qm importdisk VM# NextCloudPi\_VM\_11-30-20.img local-zfs From Proxmox Web interface - add the unused disk to the VM - In VM options set boot to the new disk - start the VM > [@michuvon](#): > > I see 3 ways achieving this: I see a 4th way and that is to create a VM install docker-ce and run docker NCP image inside the VM. ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [April 13, 2021, 2:34pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/3 "2021-04-13T14:34:18Z")
Thanks @OliverV forgot about wget, that makes it more easy. But it seems I’m still doing something wrong. I can see the unused disk, and I’m able to add it, but the VM does not boot. ![Screenshot 2021-04-13 at 16.30.51](https://help.nextcloud.com/uploads/default/original/3X/3/8/38fce07336791107487ff4ed9b29d2b29b18e7d6.png) ![Screenshot 2021-04-13 at 16.31.15](https://help.nextcloud.com/uploads/default/original/3X/2/9/298cecc2eea48c76137867a6c6070fb6f4acde76.png) ---
**Author:** ![OliverV](https://help.nextcloud.com/user_avatar/help.nextcloud.com/oliverv/32/5741_2.png) [@OliverV](https://help.nextcloud.com/u/OliverV)\ **Post date:** [April 13, 2021, 2:47pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/4 "2021-04-13T14:47:30Z")
Go to Options and edit the boot device and set to scsi1, then boot. (edit) edited earlier comment also, to add this step. ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [April 14, 2021, 12:33pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/5 "2021-04-14T12:33:20Z")
Thanks, I added it to the guide and followed the steps myself. I now work on post installation, which I also want to document. But I once again reach my technical knowledge limit. I want to add a drive just for data to the VM. I was able to passthrough the secondary internal drive to the VM and with `lsblk` it shows up as `sda` in the ncp-VM Should I format manually to BTRFS so I can use snapshots? If so, how to do that, I struggle to find information on how to go about it. ---
**Author:** ![OliverV](https://help.nextcloud.com/user_avatar/help.nextcloud.com/oliverv/32/5741_2.png) [@OliverV](https://help.nextcloud.com/u/OliverV)\ **Post date:** [April 14, 2021, 12:51pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/6 "2021-04-14T12:51:54Z")
in vm terminal run (this will _ **destroy** _ any data on the drive!!!) fdisk -c /dev/sda (g)create a gpt partition table (n)create a new partion, just hit enter to all (defaults to Linux and max size) (w)save and exit run mkfs.ext4 /dev/sda1 You can now create a mountpoint and mount it mkdir /media/mymount mount /dev/sda1 /media/mymount Check with df -hT ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [October 15, 2021, 7:38pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/7 "2021-10-15T19:38:38Z")
I’ve just realsed that @nachoparker added LXC/LXD support [https://github.com/nextcloud/nextcloudpi/commits/master/README.md](https://github.com/nextcloud/nextcloudpi/commits/master/README.md) However, I have no idea on how to deploy it. 👇 👇 👇 👇 ### Run in LXD ```auto lxc import NextCloudPi_LXD_09-29-21.tar.bz lxc start ncp ``` Anyone knows how this works? Please reach out to me, so I can update documentation or just edit the doc in the first post (wiki) yourself. ---
**Author:** ![nachoparker](https://help.nextcloud.com/user_avatar/help.nextcloud.com/nachoparker/32/2975_2.png) [@nachoparker](https://help.nextcloud.com/u/nachoparker)\ **Post date:** [October 15, 2021, 7:43pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/8 "2021-10-15T19:43:09Z")
thanks, it would be great to add this here and to [docs.nextcloudpi.com](http://docs.nextcloudpi.com) ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [October 15, 2021, 7:46pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/9 "2021-10-15T19:46:33Z")
I try to keep the [Getting started with: NextCloudPi on Proxmox](https://docs.nextcloudpi.com/en/start-with-ncp-proxmox/) on [docs.nextcloudpi.com](http://docs.nextcloudpi.com) updated. And once we got together a complete guide on LXC/LXD I will also post it there. ---
**Author:** ![gullygossner](https://help.nextcloud.com/letter_avatar/gullygossner/32/5_5575768a8748004e209b776fc1b2916d.png) [@gullygossner](https://help.nextcloud.com/u/gullygossner)\ **Post date:** [October 29, 2021, 8:54pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/10 "2021-10-29T20:54:41Z")
I have been trying to install NCP via method 3. It is successful but I am not presented with the activation for the initial password. Am I missing something? ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [October 29, 2021, 9:08pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/11 "2021-10-29T21:08:07Z")
Thanks for the feedback. I did not use this method myself, so I’m not certain, but it thinks the activation screen should show up. So what happens if you go to the IP of the VM? You say there is no activation page, are you landing at the login? If yes, you can use the terminal and `sudo ncp-config` to reset the password. * * * otherwise, maybe @OliverV can help? ---
**Author:** ![gullygossner](https://help.nextcloud.com/letter_avatar/gullygossner/32/5_5575768a8748004e209b776fc1b2916d.png) [@gullygossner](https://help.nextcloud.com/u/gullygossner)\ **Post date:** [October 29, 2021, 9:15pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/12 "2021-10-29T21:15:46Z")
yes I just hit the landing page. In the terminal page it asks for login but again I don’t know the credentials. ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [October 29, 2021, 9:28pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/13 "2021-10-29T21:28:37Z")
oh, yes, obviously, as you have installed a finished VM image that is all set. @nachoparker what is the default **user** and **passwd** of the VM image? @gullygossner try **user** : root **password** : root in the meantime. And drop me a line if it worked, I will add it in the doc above. ---
**Author:** ![gullygossner](https://help.nextcloud.com/letter_avatar/gullygossner/32/5_5575768a8748004e209b776fc1b2916d.png) [@gullygossner](https://help.nextcloud.com/u/gullygossner)\ **Post date:** [October 29, 2021, 9:57pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/14 "2021-10-29T21:57:15Z")
unfortunately root root does not work ☹ ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [October 29, 2021, 10:03pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/15 "2021-10-29T22:03:15Z")
try **user** : root **password** : ownyourbits or **password** : vagrant thanks @nachoparker ---
**Author:** ![nachoparker](https://help.nextcloud.com/user_avatar/help.nextcloud.com/nachoparker/32/2975_2.png) [@nachoparker](https://help.nextcloud.com/u/nachoparker)\ **Post date:** [October 29, 2021, 10:26pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/16 "2021-10-29T22:26:57Z")
This is tested automatically and definitely works. You have to find out the IP of the VM and then input that IP in your browser. The activation page will pop up. ---
**Author:** ![nachoparker](https://help.nextcloud.com/user_avatar/help.nextcloud.com/nachoparker/32/2975_2.png) [@nachoparker](https://help.nextcloud.com/u/nachoparker)\ **Post date:** [October 29, 2021, 10:27pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/17 "2021-10-29T22:27:46Z")
To clarify, root/vagrant (will be root/ownyourbits in the next release) is the Unix password if you use the VM directly from the hypervisor (not ncp-web, not NC, not SSH). ---
**Author:** ![gullygossner](https://help.nextcloud.com/letter_avatar/gullygossner/32/5_5575768a8748004e209b776fc1b2916d.png) [@gullygossner](https://help.nextcloud.com/u/gullygossner)\ **Post date:** [October 30, 2021, 2:30am UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/18 "2021-10-30T02:30:08Z")
> [@michuvon](#): > > **user** : root > **password** : ownyourbits > or **password** : vagrant vagrant was the ticket to get in from the console and reset my password. Thank you ---
**Author:** ![michuvon](https://help.nextcloud.com/user_avatar/help.nextcloud.com/michuvon/32/40749_2.png) [@michuvon](https://help.nextcloud.com/u/michuvon)\ **Post date:** [November 7, 2021, 11:00pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/22 "2021-11-07T23:00:20Z")
@nachoparker I believe someone else already reported that they have never seen the Activation page but got straight to the NC-Login page. Can it be that the VM Image is activated already? I will keep an eye on it and might test myself, and if there is something, I’ll raise a issue on github. ---
**Author:** ![nachoparker](https://help.nextcloud.com/user_avatar/help.nextcloud.com/nachoparker/32/2975_2.png) [@nachoparker](https://help.nextcloud.com/u/nachoparker)\ **Post date:** [November 8, 2021, 4:36pm UTC](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487/23 "2021-11-08T16:36:28Z")
oh gosh, I tested it and I guess you are right, must have been packaged after the activation automatic testing. I’ll create a new one [Next page](https://help.nextcloud.com/t/getting-started-with-nextcloudpi-on-proxmox/113487.md?page=2)