Porting to a new device/Upstreaming
Appearance
With the port in a working state, the final step is to upstream it so that other people can use it. After this step, the device will be selectable in pmbootstrap.
Creating a wiki page for the device
Every supported device needs to have a page on the postmarketOS wiki describing its status and installation/flashing steps.
- To be able to create and edit pages, request an account on the postmarketOS wiki. Accounts are typically approved within a day of their request; if not, feel free to ping a wiki admin in the #postmarketOS-wiki Matrix/IRC channel.
- Familiarize yourself with the wiki editor's guide and wiki rules.
- Once your account is created, create a wiki page for your device using the template from Help:Device page.
Upstreaming the device port
Once your port is booting, upstream the device and kernel package to pmaports. With this, your port will become a part of postmarketOS and will be selectable for all users in pmbootstrap init.
- Create an account on the postmarketOS GitLab instance; this is where postmarketOS development happens, and where the
pmaportsrepository is hosted. - Once your account is created, follow the steps in Git workflow to prepare a MR (merge request) with your device port.
Learn how to work with
git to prepare your port for submission, and how to create a merge request on postmarketOS's GitLab instance.Next steps
Getting more features working
After submitting your port, you can keep working on it to enable more features! You can find more information on component-specific pages - see Getting individual components working.