Initial setup with /boot/firmware/inital.zip

I just set up a new openHABian system on a Raspi 4 with 4GB, new SD card.

And wanted to share my experience:

  • According to the documentation / tutorial, I activated the option to restore my backup:
# the file needs to be a zip archive created from openhab-cli backup and placed
# in the directory of the first SD partition
# ATTENTION: keep /boot/firmware as the directory if you provide an absolute path
  • After I wrote the SD card, a drive “bootfs” was mounted on my Windows Laptop as drive D. So I assumed this is the boot partition. Therefore I created a directory “boot” in it and in that a directory “firmware”. In that I put my backup zip file and renamed it to initial.zip. Thus, the file was at (Windows-Path):
    D:\boot\firmware\initial.zip
    I also correctly removed the SD card.
  • Now during the setup of the system, the backup could not be found. What did I do wrong?
  • Restore from the backup folder triggered by openhabian-config went without problems.
  • I wanted to directly have 5.0 M4. This is not possible initially, would it be worth spending an option at openhabian.conf to install latest release / latest milestone / latest snapshot?

You should not have created boot but should have placed the .zip in the existing firmware folder.
Also set debug=maximum in openhabian.conf to generate a meaningful debug log.

Sorry, there was no firmware folder. Otherwise I would have seen it und would have done it. Could that have something to do with what was mounted in Windows? Is “bootfs” the right partition?

then create it (I mean firmware, not boot)

if that does not work put initial.zip right on D:\ root

Installation guide says currently:

ATTENTION: keep /boot/firmware as the directory if you provide an absolute path

So I would propose to add:

So use the existing firmware folder in the boot partition or create it and place the backup file named initial.zip in that folder.

Maybe that makes it a tiny bit clearer. I have to admit that I could have read somewhere else that the path of openhabian.conf is /boot/openhabian.conf. But I didn’t and therefore I missed that the partition “bootfs” in Windows corresponds to /boot/ in Linux. Maybe that could also be mentioned somewhere. Then it is idiot-proof :slight_smile: .

I don’t know which Installation Guide you are referring to, but then help with improving that yourself please. Create a Pull Request. There’s a small link at the bottom of the docs web page to do that.

OK, done:

Can you approve?

1 Like