Skip to content

Commit

Permalink
doc: update apt:geoip autoinstall reference
Browse files Browse the repository at this point in the history
  • Loading branch information
Chris-Peterson444 committed Aug 23, 2024
1 parent 9cc562c commit 05d5ca7
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions doc/reference/autoinstall-reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -497,21 +497,28 @@ geoip
* **type:** boolean
* **default:** ``true``

If ``geoip`` is set to ``true`` and one of the candidate primary mirrors has the special value ``country-mirror``, a request is made to ``https://geoip.ubuntu.com/lookup``. Subiquity then sets the mirror URI to ``http://CC.archive.ubuntu.com/ubuntu`` (or similar for ports) where ``CC`` is the country code returned by the lookup. If this section is not interactive, the request expires after 10 seconds.
If ``geoip`` is set to ``true`` and one of the candidate primary mirrors has the special value ``country-mirror``, a request is made to ``https://geoip.ubuntu.com/lookup``. Subiquity then sets the mirror URI to ``http://CC.archive.ubuntu.com/ubuntu`` where ``CC`` is the country code returned by the lookup. If this section is not interactive, the request expires after 10 seconds.

If the legacy behaviour (i.e., without mirror-selection) is in use, the geolocation request is made if the mirror to be used is the default, and its URI is replaced by the proper country mirror URI.

To specify a mirror, use a configuration like this:
Examples:

.. code-block:: yaml
# Use the automatically determined country mirror first, followed by an explicit backup mirror.
autoinstall:
apt:
mirror-selection:
primary:
- uri: YOUR_MIRROR_GOES_HERE
- country-mirror
- uri: http://archive.ubuntu.com/ubuntu
- uri: http://dk.archive.ubuntu.com/ubuntu
geoip: true
# Disable automatic country mirror detection (i.e. only use http://archive.ubuntu.com/ubuntu)
autoinstall:
apt:
geoip: false
To add a PPA:

Expand Down

0 comments on commit 05d5ca7

Please sign in to comment.