Skip to content

SeedSigner/seedsigner-os

main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

Gitea

SeedSigner OS

Purpose

The goal of this project is to make the easiest, fastest, safer and most painless way to build a custom OS that runs SeedSigner. For that reason we have pick Buildroot.

🛂 Security

  1. SeedSigner OS boots from RAM. So, once you see the SeedSigner splash screen, you can release the MicroSD and keep using the device!
  2. No /rootfs partition on MicroSD
  3. Many Kernel modules disabled by default:
  • Networking and Bluetooth
  • SWAP
  • I2C
  • Serial
  • USB
  • Pulse-Width Modulation (PWM)
  • ...
  1. NO HDMI
  2. NO Serial connection TTL
  3. NO Software that can try to use or access to the wireless, audio, RF...
  4. We will have only /boot partition in our MicroSD. In which is located a zImage file (read-only) that contains the Linux Kernel and RootFS
  5. Images are not reproducible. Unique hash in every compilation
  6. ...

🛠 Building

🔧 Steps to build an image:

  1. Clone the repository in your machine:
git clone --recursive https://github.com/SeedSigner/seedsigner-os.git
  1. Go to the work directory:
cd seedsigner-os/build_workdir/
  1. Use ./builder to build the image:
./builder -i

The final image seedsigner_os.img is going to be located under build_workdir/images/

ℹ️ ./builder help

You can see the different build options with ./builder -h

📝 See and modify configurations

Buildroot:

make menuconfig

Linux Kernel:

make linux-menuconfig

Busybox:

busybox-menuconfig

📑 Requirements

Because we are cross-compiling with Buildroot, we need certains tools for that task. Usually, Debian based OS have all dependences already installed by default. But using this command you can install the main packages in case needed:

sudo apt update && sudo apt install make binutils build-essential gcc g++ patch gzip bzip2 perl tar cpio unzip rsync file bc

About

SeedSigner OS | Minimal Raspberry Pi image made for SeedSigner

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published