README.md 1.57 KB
Newer Older
Blaine Murphy's avatar
Blaine Murphy committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
# Wasteland Jukebox OS
Operating system setup script for the
[Wasteland Jukebox](https://blaines.world/projects/wasteland-jukebox.html).
This guide assumes the use of a Linux box for preparation and a Raspberry Pi
3B+ for the target SBC. Parts of this guide are taken from [the official Alpine
guide](https://wiki.alpinelinux.org/wiki/Raspberry_Pi).


## Preparation
The following steps are performed on a Linux host to prepare an SD card for the
Pi:

 1. Download the latest [Alpine image](https://alpinelinux.org/downloads/) for
    Raspberry Pi (for 3B+ use the `armv7` image)
 2. Insert the SD card into the computer
 3. Create a bootable FAT32 partition on the card using
    [fdisk](https://wiki.alpinelinux.org/wiki/Create_a_Bootable_USB#Format_USB_stick)
    or a GUI tool like gparted
 4. Mount the SD card
 5. Extract the content of the downloaded Alpine image to the root of the card
 6. Copy the file `usercfg.txt` and the directory `install` from this directory
    to the root of the SD card
 7. Unmount and remove the SD card from the computer


## Installation
The following steps are performed on the Raspberry Pi:

 1. Connect an ethernet cable to the Pi if using a wired connection
 2. Insert the SD card into the Pi and plug power in to turn it on
 3. Login using username `root` and empty password
 4. Run `setup-alpine` and complete the setup wizard
 5. Run `cd /media/mmcbkl0p1/install; sh install` to run the installer
 6. Run `reboot` to reboot into the initialized system


## Licensing
Source in this repository is licensed under the 2-clause BSD license, see
`LICENSE` for details.