pmbootstrap, with Synit changes

Go to file

Attila Szöllősi e4875e54fa Fix menuconfig arch check (#1259 ) We don't use 'arch="all"' in our kernels anymore (that does not make sense, since each arch needs its own kernel config). This patch fixes the menuconfig code to work with multiple values in the "arch" field.		2018-02-25 17:44:01 +00:00
aports	samsung-i9195: fix kernel config (#1260 )	2018-02-25 17:32:35 +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	Fix menuconfig arch check (#1259 )	2018-02-25 17:44:01 +00:00
test	Make proprietary drivers optional (1/2): pmbootstrap changes (#1254 )	2018-02-24 21:49:10 +00:00
.gitignore	gitignore: Add pytest cache	2018-02-06 23:10:25 +01:00
.travis.yml	Testsuite: Run UIs in Qemu and check running processes and more (#982 )	2018-02-02 00:16:29 +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