Mirror/pmbootstrap
1
0
Fork 1
mirror of https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git synced 2025-07-12 19:09:56 +03:00
Code Issues Wiki Activity

treewide: lint markdown files (MR 2485)

Browse source 
lint all the markdown files so they pass markdownlint.

Signed-off-by: Caleb Connolly <caleb@postmarketos.org>
This commit is contained in:
Caleb Connolly 2024-11-12 01:51:29 +01:00 • committed by Oliver Smith
parent 14d9134d8b
commit 65419c2bbe
No known key found for this signature in database
GPG key ID: 5AE7F5513E0885CB
3 changed files with 235 additions and 172 deletions
Download patch file Download diff file Expand all files Collapse all files

49
docs/mirrors.md
View file

@ -1,42 +1,45 @@
# Mirror Configuration
A typical postmarketOS installation has one Alpine Linux mirror configured as well as one
postmarketOS mirror. As Alpine's CDN mirror is used by default, it should be suitable for most
users. The postmarketOS mirror can be configured interactively with `pmbootstrap init`, under
"additional options".
A typical postmarketOS installation has one Alpine Linux mirror configured as
well as one postmarketOS mirror. As Alpine's CDN mirror is used by default, it
should be suitable for most users. The postmarketOS mirror can be configured
interactively with `pmbootstrap init`, under "additional options".
Find the currently selected mirrors in the output of `pmbootstrap status`, as well as in
`/etc/apk/repositories` for initialized chroots and finished installations.
Find the currently selected mirrors in the output of `pmbootstrap status`, as
well as in `/etc/apk/repositories` for initialized chroots and finished
installations.
## Advanced
Some advanced use cases are supported by configuring the mirrors directly, either by running the
non-interactive `pmbootstrap config` command or by editing `pmbootstrap_v3.cfg`. Find the lists of
mirrors at [mirrors.alpinelinux.org](https://mirrors.alpinelinux.org) and
Some advanced use cases are supported by configuring the mirrors directly,
either by running the non-interactive `pmbootstrap config` command or by editing
`pmbootstrap_v3.cfg`. Find the lists of mirrors at
[mirrors.alpinelinux.org](https://mirrors.alpinelinux.org) and
[mirrors.postmarketos.org](https://mirrors.postmarketos.org).
### Change the mirrors non-interactively
```
$ pmbootstrap config mirrors.alpine http://uk.alpinelinux.org/alpine/
$ pmbootstrap config mirrors.pmaports http://postmarketos.craftyguy.net/
$ pmbootstrap config mirrors.systemd http://postmarketos.craftyguy.net/extra-repos/systemd/
```sh
pmbootstrap config mirrors.alpine http://uk.alpinelinux.org/alpine/
pmbootstrap config mirrors.pmaports http://postmarketos.craftyguy.net/
pmbootstrap config mirrors.systemd http://postmarketos.craftyguy.net/extra-repos/systemd/
```
Reset to default works as with all config options:
```
$ pmbootstrap config -r mirrors.alpine
$ pmbootstrap config -r mirrors.pmaports
$ pmbootstrap config -r mirrors.systemd
```sh
pmbootstrap config -r mirrors.alpine
pmbootstrap config -r mirrors.pmaports
pmbootstrap config -r mirrors.systemd
```
### Disable the postmarketOS mirror
This is useful to test bootstrapping from pure Alpine:
```
$ pmbootstrap config mirrors.pmaports none
$ pmbootstrap config mirrors.systemd none
```sh
pmbootstrap config mirrors.pmaports none
pmbootstrap config mirrors.systemd none
```
### Use `_custom` mirrors
@ -49,7 +52,7 @@ to build packages with a WIP repository enabled in addition to the final
repository, but could also be used if you have another custom repository that
you want to use in addition to the postmarketOS binary package repository.
```
$ pmbootstrap config mirrors.pmaports_custom http://custom-repository-here
$ pmbootstrap config mirrors.systemd_custom http://custom-repository-here/extra-repos/systemd
```sh
pmbootstrap config mirrors.pmaports_custom http://custom-repository-here
pmbootstrap config mirrors.systemd_custom http://custom-repository-here/extra-repos/systemd
```