pmbootstrap, with Synit changes

Go to file

Oliver Smith 8a0413ba93 WIP: pmbootstrap deviceinfo_parse Quick and dirty version, that takes pkgnames as argument instead of device names (which would make more sense, like kconfig_check). Used this to debug #1325.		2018-03-12 21:15:28 +01:00
aports	postmarketos-ui-xfce: Update to 0.2 (#1326 )	2018-03-12 19:17:36 +00:00
helpers	Rudimentary ZSH autocompletion helper (#1232 )	2018-02-17 22:46:20 +00:00
keys	Close #871 : Enable binary repository (#887 )	2017-11-19 15:04:08 +00:00
pmb	WIP: pmbootstrap deviceinfo_parse	2018-03-12 21:15:28 +01:00
test	aportgen: Gracefully handle old aports_upstream (#1291 )	2018-03-11 14:18:21 +00:00
.gitignore	gitignore: Add pytest cache	2018-02-06 23:10:25 +01:00
.travis.yml	aportgen: Gracefully handle old aports_upstream (#1291 )	2018-03-11 14:18:21 +00:00
CONTRIBUTING.md	CONTRIBUTING.md: Mention that we squash PRs (#651 )	2017-09-29 21:23:46 +00:00
LICENSE	Initial commit	2017-05-26 19:25:48 +00:00
MANIFEST.in	Close #327 : Add initial setup.py (#443 )	2017-09-02 19:30:40 +00:00
README.md	Update README.md (#1249 )	2018-02-22 22:50:39 +01:00
pmbootstrap.py	Happy new year! (update copyright to 2018)	2018-01-04 04:53:35 +01:00
setup.cfg	Close #327 : Add initial setup.py (#443 )	2017-09-02 19:30:40 +00:00
setup.py	Close #327 : Add initial setup.py (#443 )	2017-09-02 19:30:40 +00:00

README.md

pmbootstrap

Introduction | Security Warning | Supported Devices | |

Sophisticated chroot/build/flash tool to develop and install postmarketOS.

For in-depth information please refer to the postmarketOS wiki.

Requirements

2 GB of RAM recommended for compiling
Linux distribution (x86, x86_64, or aarch64)
- Windows subsystem for Linux (WSL) does not work! Please use VirtualBox instead.
- Kernels based on the grsec patchset do not work (Alpine: use linux-vanilla instead of linux-hardened, Arch: linux-hardened is not based on grsec)
- On Alpine Linux only: apk add coreutils
Python 3.4+
OpenSSL

Usage

Assuming you have a supported device, you can build and flash a postmarketOS image by running through the following steps. For new devices check the porting guide.

First, clone the git repository and initialize your pmbootstrap environment:

$ git clone https://github.com/postmarketOS/pmbootstrap
$ cd pmbootstrap
$ ./pmbootstrap.py init

While running any pmbootstrap command, it's always useful to have a log open in a separate window where further details can be seen:

$ ./pmbootstrap.py log

It's now time to run a full build which will create the boot and system images:

$ ./pmbootstrap.py install

Once your device is connected and is ready to be flashed (e.g. via fastboot), you can run a flash of the kernel (boot) and system partitions:

$ ./pmbootstrap.py flasher flash_kernel
$ ./pmbootstrap.py flasher flash_system

After a reboot, the device will prompt for the full-disk encryption password, which you typed in the install step (unless you have disabled full-disk encryption with --no-fde). Once the partition has been unlocked it is possible to connect via SSH:

$ dhclient -v enp0s20f0u1
$ ssh user@172.16.42.1

Development

Testing

Install pytest (via your package manager or pip) and run it inside the pmbootstrap folder.

License

GPLv3