synit
/
pmbootstrap
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
pmbootstrap, with Synit changes
565 Commits 46 Branches 0 Tags 32 MiB
Python 97.9%
Shell 2.1%
Go to file
clayton craft 2587e430ed Fix console blanking (#676) 
So I was wrong.. /etc/issue needs to contain the escape sequence output
by setterm,  not the actual call to setterm itself. My previous testing
of this was faulty, which led me to believe the previous implementation
of this would work.
 		2017-10-02 22:41:19 +00:00
aports Fix console blanking (#676) 2017-10-02 22:41:19 +00:00
keys Hello, there! 2017-05-26 22:08:45 +02:00
pmb Fix #673: Only load loop module if it is not already loaded in the kernel (#675) 2017-10-02 21:53:01 +00:00
test Fix #151: git ambiguous argument error (#531) 2017-09-25 22:05:29 +00:00
.gitignore gitignore: Added vim temporary files 2017-06-25 21:40:49 +02:00
.travis.yml Close #554: kernel config checking (#589) 2017-09-18 21:36:54 +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 Make sure to tell people WSL is not supported (#507) 2017-09-03 14:07:22 +00:00
pmbootstrap.py Close #327: Add initial setup.py (#443) 2017-09-02 19:30:40 +00: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 | travis badge

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

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

Requirements

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