synit
/
pmbootstrap
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
pmbootstrap, with Synit changes
443 Commits 46 Branches 0 Tags 32 MiB
Python 97.9%
Shell 2.1%
Go to file
Oliver Smith c33db6315e Fix #463: Ignore exit code from parted (#465) 
Parted often succeeds, but then returns a non-zero exit code, because
it can not inform the kernel of the changes.
In most cases this is not even necessary, so it really should not
fail there.
When the error was fatal, pmbootstrap will crash shortly afterwards
when it tried to mount or run mkfs on the partition anyway.
 		2017-08-25 17:39:52 +00:00
aports Initial Huawei Ascend Y530 support (#462) 2017-08-25 15:47:32 +00:00
keys Hello, there! 2017-05-26 22:08:45 +02:00
pmb Fix #463: Ignore exit code from parted (#465) 2017-08-25 17:39:52 +00:00
test Recovery installer zip (#404) 2017-08-24 21:07:36 +00:00
.gitignore gitignore: Added vim temporary files 2017-06-25 21:40:49 +02:00
.travis.yml Fix #381: Completely disable Travis mail notifications 2017-08-19 03:35:28 +02:00
CONTRIBUTING.md contributing: fixed typos and added some links (#372) 2017-08-14 14:23:35 +00:00
LICENSE Initial commit 2017-05-26 19:25:48 +00:00
README.md Added memory requirements to README (#454) 2017-08-24 17:33:22 +00:00
pmbootstrap.py Close #174: Put frontend functions in extra file (#185) 2017-07-18 19:01:11 +00:00

README.md

pmbootstrap

Introduction | Security Warning | Supported Devices | travis badge

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

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

Requirements

  • Linux distribution (x86_64 or aarch64)
  • 2 GB of RAM recommended for compiling
  • 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 provide a USB network interface, which we request an IP from, and telnet into to open the full-disk encryption on the main system partition:

$ dhclient -v enp0s20f0u1
$ telnet 172.16.42.1

Trying 172.16.42.1...
Connected to 172.16.42.1.
Escape character is '^]'.

Enter passphrase for /dev/mapper/mmcblk0p25p2: 
Connection closed by foreign host.

Once the partition has been unlocked it is possible to connect via SSH:

$ 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