channels.cfg is in the master branch of pmaports.git and maps postmarketOS pmaports branches to Alpine Linux aports branches for each release channel.
# Reference: https://postmarketos.org/channels.cfg [channels.cfg] recommended=edge [edge] description=Rolling release channel branch_pmaports=master branch_aports=master [latest] description=Upcoming stable release (WIP, do not use!) branch_pmaports=release/20.04 branch_aports=3.11-stable
Metadata that does not belong in a channel section.
||What pmbootstrap will recommend to install for new users. Initially this will be edge, until latest is ready, then we switch to latest.|| |
edge, latest, latest-next, legacy
Channel sections, for which it will be possible to install postmarketOS.
latest will always be present,
legacy only during transition phases from one release to the next one.
|| Text displayed next to the branch in
||Branch of postmarketOS pmaports.git|| |
||Branch of Alpine Linux aports.git|| |
pmbootstrap reads the file from the master/origin branch of pmaports.git. This way, it will always use the latest fetched version, even if the last checked out master branch (master without the origin/ infront) is not up-to-date. This is likely to happen if a release branch was checked out, as a
git pull would then only update the reference from the release branch related to origin's release branch, master's reference would not change.
Release branches do not have a copy of the file, this would just require us to needlessly keep them all in sync.
View it with:
$ cd $(pmbootstrap config aports) # change directory to local checkout of pmaports.git $ git show origin/master:channels.cfg
For development and testing, it is possible to override the path with
$ pmbootstrap --config-channels /tmp/channels.cfg status