Self Install on Raspberry Pi 4 (or 3)
HomeDrive runs on 64-bit Raspberry Pi. While you can buy our preinstalled
hardware at our website, you can also self-install it on your
existing 64-bit Raspberry Pi for free. It works on both Raspberry Pi 3 and
4, but we suggesting using a Raspberry Pi 4 for more acceptable Nextcloud
Raspberry Pi 2 or earlier is not supported, as they are 32-bit only.
- A Raspberry Pi 3 or 4 with power cable
- A computer that can flash a micro SD card.
- A micro SD card that is at least 16GB.
- An Ethernet cabel network that provides
Internet connectivity. This is normally your home network router.
- A monitor with HDMI and a keyboard, or alternatively serial console
connector via Raspberry Pi's GPIO pins.
- Create an endpoint on HomeDrive
website. This endpoint account will be used for fetching future
HomeDrive software updates, and also for establishing the end-to-end
encrypted proxy tunnel so that you can visit your HomeDrive from the
Internet. The endpoint account name is a sub domain label.
- Download the image here and flash it to the SD card. You can use
a tool like Balena Etcher.
- Plug the SD card into the Raspberry Pi board.
- Plug in the monitor and the keyboard (or connect the serial console).
- Connect the board to the Internet via an Ethernet cable.
- Connect the board to its power and boot it up.
- Wait until you see the
burmilla$ prompt on the console.
- When prompt for the endpoint's name, enter the endpoint name that you
- It will then ask you for the one-time installation code. You can find the
code on the endpoint's page. If the code has expired or about to expire,
you can click the button on the endpoint's page to receate a new one.
- After filling in the endpoint's name and the one-time installation code,
it will start the installation. Depending on the performance of the board,
the SD card and the network, it might take 10 to 40 minutes to complete
the full installation.
You can track the installation progress with this
docker logs --follow core.homedrv (and press
exit following at any time).
After HomeDrive is successfully installed, you can visit it at
domain your-endpoint.homedrv.com (or your-endpoint.homedrv.eu for ones in the
Europe region). The installation generates a password with random characters,
and you can find the password on the endpoint's page. The username is
After installation, please change your Nextcloud password and set up some
form of 2-factor authentication. Since your Nextcloud is exposed to the
Internet, setting up 2-factor authentication is very important to keep your
service and data secure.
The keyboard and the monitor will be no longer needed after the installation.
If you need help, feel free to chat with us using the chat bottom on the
bottom right corner, or send us an email at
If you still find these steps too complicated to follow, you can
buy a preinstalled HomeDrive device, from $99.