Skip to content

Instantly share code, notes, and snippets.

@jvolker
Last active June 22, 2022 05:42
Show Gist options
  • Save jvolker/96a52b05459316643f8e110ff46b8e32 to your computer and use it in GitHub Desktop.
Save jvolker/96a52b05459316643f8e110ff46b8e32 to your computer and use it in GitHub Desktop.
Guide on how to use preinstalled Openframe images for Raspberry Pi and on how to create those images.

These are working Openframe images for Raspberry Pi.

Using this image

  1. Download:
    For Raspberry Pi 4 or for all other Pis
    based on 2019-07-10-raspbian-buster
  2. Use balenaEtcher to write the image to an SD card (min. 4GB).
  3. Optional – Remove and return the SD card into your PC to edit/add to the boot partition of the SD card to do the following:
  • Add Wifi: edit this file accordingly (country code, wifi name and password) and add it
  • Enable SSH: add this file (yes, it's an empty file named ssh)
  • Increase GPU memory even further: edit config.txt and change gpu_mem=256 to gpu_mem=512. Read more on this here.
  1. Boot the Pi and run sudo raspi-config --expand-rootfs && sudo reboot which will expand the file system and reboot the Pi

How to create an Openframe image from scratch?

Create Image

  1. Download latest Raspbian Buster with desktop
  2. Use balenaEtcher to write the image to an SD card
  3. Place this SSH file on the boot partition
  4. Boot the Pi with ethernet cable plugged in (don’t use wifi as your credentials will remain stored on the image)
  5. SSH into the Pi ssh pi@raspberrypi or ssh pi@raspberrypi.local or use an IP address, e.g. ssh pi@192.168.0.20 password = raspberry
  6. Run: bash -c "$(curl https://gist.githubusercontent.com/jvolker/7d61d2550261f838c473ea6f3111c458/raw/80ac162ffcb6806028e813a4bb25ea26d0abb7b4/create-openframe-image.sh)"
  7. Do Backup with ApplePi-Baker with "Partition resize” enabled

It does the following:

  • Changes hostname to: OpenframeRaspi
  • Changes password to: openframe
  • Changes boot mode to command line
  • Updates all packages
  • Sets GPU memory to 256MB to make shaders and image extension work
  • Installs Openframe and default extensions
  • Disables SSH

Note: You can call the script with the following argument to skip updating the packages:

bash -c "$(curl https://gist.githubusercontent.com/jvolker/7d61d2550261f838c473ea6f3111c458/raw/80ac162ffcb6806028e813a4bb25ea26d0abb7b4/create-openframe-image.sh)" --skipUpdatePackages

Test

Use balenaEtcher to write the backed up image to an SD card. Actually, it might be okay to use continue with what’s already on the SD card.

  1. Boot the Pi and run sudo raspi-config --expand-rootfs && sudo reboot which will expand the file system and reboot the Pi
  2. Run openframe, enter your Openframe credentials and test all default extensions.

Done!

@wraybowling
Copy link

It may be important to note that these images will require a 4GiB microSD card. I just wasted an hour trying to not completely follow directions (using dd), flashing to a 2GiB card only to see the kernel panic.

@jvolker
Copy link
Author

jvolker commented Jul 20, 2020

It may be important to note that these images will require a 4GiB microSD card.

Thanks, I've edited it.

@ludoth
Copy link

ludoth commented May 26, 2022

Might be important to flag that the server has been acting up for a while. "Server not available"... Is there a work around?

@handlenyc
Copy link

Might be important to flag that the server has been acting up for a while. "Server not available"... Is there a work around?

I too am seeing "ERROR: The server is not available." repeatedly as I am trying this for the first time. I've looked online for solutions, have tried a couple, but have not been able to get past this as of June 22. 2022. Does anyone have links to documentation for troubleshooting or solutions? Thank you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment