Difference between revisions of "Pacman-mirrors"

__TOC__

__TOC__

<translate>

<translate>

Pacman-mirrors is a Manjaro specific utility for generating and maintaining the system mirrorlist. This article covers current version 4.x.

Pacman-mirrors is a Manjaro specific utility for generating and maintaining the system mirrorlist. This article covers current version 4.x.

Pacman-mirrors uses the information available on the [http://repo.manjaro.org Mirrorservice]

Pacman-mirrors uses the information available on the [http://repo.manjaro.org Mirrorservice]

Manjaro uses pacman for system maintenance, updates and new installs. For pacman to function, a list of servers, or more commonly known as mirrors, with Manjaro software packages is required. As Manjaro has many mirrors all over the world it is feasible to use the mirrors closest to your location and preferably also up-to-date.

Manjaro uses pacman for system maintenance, updates and new installs. For pacman to function, a list of servers, or more commonly known as mirrors, with Manjaro software packages is required. As Manjaro has many mirrors all over the world it is feasible to use the mirrors closest to your location and preferably also up-to-date.

For most functions, a working internet connection is required. From v4, Pacman-Mirrors will check if network is online. It is doing so by querying some generic websites. The sites are chosen due to their general avaiability.

For most functions, a working internet connection is required. From v4, Pacman-Mirrors will check if network is online. It is doing so by querying some generic websites. The sites are chosen due to their general avaiability.

# wikipedia.org

# wikipedia.org

# github.com

# github.com

# bitbucket.org

# bitbucket.org

Should you get certificates error and pacman-mirrors throws a message of missing internet connection - you must verify your computers firmware date and time as this is probably completely off either because of configuration or a malfunctioning CMOS battery.

Should you get certificates error and pacman-mirrors throws a message of missing internet connection - you must verify your computers firmware date and time as this is probably completely off either because of configuration or a malfunctioning CMOS battery.

The app is run by an ordinary user with superuser rights from the console and when no arguments are given it will display pacman-mirrors version followed by status of the mirrors currently listed in your mirrorlist.

The app is run by an ordinary user with superuser rights from the console and when no arguments are given it will display pacman-mirrors version followed by status of the mirrors currently listed in your mirrorlist.

Exactly how the app generates the mirrorlist is controlled by supplying arguments on the commandline.

Exactly how the app generates the mirrorlist is controlled by supplying arguments on the commandline.

{{Tip|Every run of pacman-mirrors requires you to syncronize your database and update your system.}}

{{Tip|Every run of pacman-mirrors requires you to syncronize your database and update your system.}}

If you fail to do so, the issue/s which had you make change might not be solved. Furthermore you might run into [[System_Maintenance|''partial-updated'']] scenario which can cause havoc in your system. For more detailed information on how pacman works you can read up on the [https://wiki.archlinux.org/index.php/System_maintenance Archlinux Wiki]

If you fail to do so, the issue/s which had you make change might not be solved. Furthermore you might run into [[System_Maintenance|''partial-updated'']] scenario which can cause havoc in your system. For more detailed information on how pacman works you can read up on the [https://wiki.archlinux.org/index.php/System_maintenance Archlinux Wiki]

All commands uses the available mirror pool.<br />

All commands uses the available mirror pool.<br />

The mirror pool can be the default full mirror pool or a customized mirror pool.<br />

The mirror pool can be the default full mirror pool or a customized mirror pool.<br />

For short versions have a look at the [https://gitlab.manjaro.org/applications/pacman-mirrors/tree/master/docs|man page] or the usage command

For short versions have a look at the [https://gitlab.manjaro.org/applications/pacman-mirrors/tree/master/docs|man page] or the usage command

  man pacman-mirrors

  man pacman-mirrors

  pacman-mirrors --help

  pacman-mirrors --help

  pacman-mirrors --version

  pacman-mirrors --version

  pacman-mirrors --status

  pacman-mirrors --status

In default mirror pool

In default mirror pool

  pacman-mirrors --country-list

  pacman-mirrors --country-list

In custom mirror pool

In custom mirror pool

  pacman-mirrors --country-config

  pacman-mirrors --country-config

  pacman-mirrors --get-branch

  pacman-mirrors --get-branch

  sudo pacman-mirrors --fasttrack && sudo pacman -Syyu

  sudo pacman-mirrors --fasttrack && sudo pacman -Syyu

An optional number can be supplied to limit the number of mirrors in the mirrorlist

An optional number can be supplied to limit the number of mirrors in the mirrorlist

  sudo pacman-mirrors --fasttrack 5 && sudo pacman -Syyu

  sudo pacman-mirrors --fasttrack 5 && sudo pacman -Syyu

Not all countries have mirrors, if geoip returns a country not in the pool all mirrors will be used.

Not all countries have mirrors, if geoip returns a country not in the pool all mirrors will be used.

  sudo pacman-mirrors --geoip && sudo pacman -Syyu

  sudo pacman-mirrors --geoip && sudo pacman -Syyu

You can customize the mirror pool to your preference.

You can customize the mirror pool to your preference.

BUT Don't limit yourself too much as pacman-mirrors '''only''' writes up-to-date mirrors to your mirrorlist.

BUT Don't limit yourself too much as pacman-mirrors '''only''' writes up-to-date mirrors to your mirrorlist.

Create a custom mirror pool using mirrors from the continent determined by querying a geolocation service

Create a custom mirror pool using mirrors from the continent determined by querying a geolocation service

  sudo pacman-mirrors --continent && sudo pacman -Syyu

  sudo pacman-mirrors --continent && sudo pacman -Syyu

Create a custom mirror pool using mirrors from Germany, France and Austria

Create a custom mirror pool using mirrors from Germany, France and Austria

  sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syyu

  sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syyu

Create a custom mirror pool using the '''--default''' mirror pool '''--interactive''' will list all available mirrors and procotols in a gui windows allowing to sort the columns and interactively select according to your preferences.

Create a custom mirror pool using the '''--default''' mirror pool '''--interactive''' will list all available mirrors and procotols in a gui windows allowing to sort the columns and interactively select according to your preferences.

  sudo pacman-mirrors --interactive --default && sudo pacman -Syyu

  sudo pacman-mirrors --interactive --default && sudo pacman -Syyu

Rank the current mirror pool using only https and http protocol

Rank the current mirror pool using only https and http protocol

  sudo pacman-mirrors --api --protocol https,http && sudo pacman -Syyu

  sudo pacman-mirrors --api --protocol https,http && sudo pacman -Syyu

Change the system branch to unstable and create a custom mirror pool using mirrors from Germany

Change the system branch to unstable and create a custom mirror pool using mirrors from Germany

  sudo pacman-mirrors --country Germany --api --set-branch unstable && sudo pacman -Syyu

  sudo pacman-mirrors --country Germany --api --set-branch unstable && sudo pacman -Syyu

Change the system branch to unstable, set configuration to use https only and create a custom mirror pool using mirrors from Germany

Change the system branch to unstable, set configuration to use https only and create a custom mirror pool using mirrors from Germany

  sudo pacman-mirrors --country Germany --api --set-branch unstable --protocol https && sudo pacman -Syyu

  sudo pacman-mirrors --country Germany --api --set-branch unstable --protocol https && sudo pacman -Syyu

You will come to a point where you want to reset to defaults

You will come to a point where you want to reset to defaults

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

All available arguments can be viewed by unfolding this block

All available arguments can be viewed by unfolding this block

[-P PROTO [PROTO...]] [-R] [-U URL]

[-P PROTO [PROTO...]] [-R] [-U URL]

METHODS:

METHODS:

   -i, --interactive    Generate custom mirrorlist

   -i, --interactive    Generate custom mirrorlist

   --continent          Use continent from geolocation

   --continent          Use continent from geolocation

API:

API:

   -a, --api            [-p PREFIX][-R][-S/-B|-G BRANCH][-P PROTO [PROTO ...]]

   -a, --api            [-p PREFIX][-R][-S/-B|-G BRANCH][-P PROTO [PROTO ...]]

   -U, --url URL        API: Replace mirror url in mirrorlist

   -U, --url URL        API: Replace mirror url in mirrorlist

MISC:

MISC:

   -G, --get-branch      Return branch from configuration

   -G, --get-branch      Return branch from configuration

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of a default configuration - click the link to the right --->

To view the content of a default configuration - click the link to the right --->

     ##

     ##

     # Branch = stable

     # Branch = stable

     ## 1) rank  - rank mirrors depending on their access time

     ## 1) rank  - rank mirrors depending on their access time

     ## 2) random - randomly generate the output mirrorlist

     ## 2) random - randomly generate the output mirrorlist

     # Method = rank

     # Method = rank

     ##  separated by comma 'https,http' or 'http,https'

     ##  separated by comma 'https,http' or 'http,https'

     ## ATM available protocols are: http, https, ftp

     ## ATM available protocols are: http, https, ftp

     # Protocols =

     # Protocols =

     ## Use only if you fully trust all ssl-enabled mirrors.

     ## Use only if you fully trust all ssl-enabled mirrors.

     # SSLVerify = True

     # SSLVerify = True

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of a default mirror pool - click the link to the right --->

To view the content of a default mirror pool - click the link to the right --->

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of a default mirror pool including mirror status - click the link to the right --->

To view the content of a default mirror pool including mirror status - click the link to the right --->

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of a default pacman-mirrors.conf - click the link to the right --->

To view the content of a default pacman-mirrors.conf - click the link to the right --->

##

##

## Branch Pacman should use (stable, testing, unstable)

## Branch Pacman should use (stable, testing, unstable)

# Branch = stable

# Branch = stable

## Generation method

## Generation method

## 1) rank  - rank mirrors depending on their access time

## 1) rank  - rank mirrors depending on their access time

# Method = rank

# Method = rank

## Define protocols and priority

## Define protocols and priority

##  separated by comma 'https,http' or 'http,https'

##  separated by comma 'https,http' or 'http,https'

# Protocols =  

# Protocols =  

## Get a list of all available counties with 'pacman-mirrors -l'

## Get a list of all available counties with 'pacman-mirrors -l'

## Value can be 'Custom' or nothing which means all

## Value can be 'Custom' or nothing which means all

# OnlyCountry =  

# OnlyCountry =  

## When set to False - all certificates are accepted.

## When set to False - all certificates are accepted.

## Use only if you fully trust all ssl-enabled mirrors.

## Use only if you fully trust all ssl-enabled mirrors.

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of the sample command - click the link to the right --->

To view the content of the sample command - click the link to the right --->

.: INFO Downloading mirrors from repo.manjaro.org

.: INFO Downloading mirrors from repo.manjaro.org

.: INFO User generated mirror list

.: INFO User generated mirror list

--------------------------

--------------------------

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of the sample mirrorlist - click the link to the right --->

To view the content of the sample mirrorlist - click the link to the right --->

##

##

## Country : Denmark

## Country : Denmark

Server = https://www.uex.dk/public/manjaro/unstable/$repo/$arch

Server = https://www.uex.dk/public/manjaro/unstable/$repo/$arch

## Country : Denmark

## Country : Denmark

Server = https://mirrors.dotsrc.org/manjaro/unstable/$repo/$arch

Server = https://mirrors.dotsrc.org/manjaro/unstable/$repo/$arch

</div>

</div>

<div class="toccolours mw-collapsible mw-collapsed">

<div class="toccolours mw-collapsible mw-collapsed">

To view the content of a custom mirror pool - click the link to the right --->

To view the content of a custom mirror pool - click the link to the right --->

</div>

</div>

PacmanMirrors has some reasonable defaults

PacmanMirrors has some reasonable defaults

  - Using stable branch

  - Using stable branch

  - Using all mirrors

  - Using all mirrors

The '''-f''' or '''--fasttrack''' argument uses mirrors which are up-to-date for your branch. Optionally you can supply a number e.g. 10

The '''-f''' or '''--fasttrack''' argument uses mirrors which are up-to-date for your branch. Optionally you can supply a number e.g. 10

The --continent argument is using a geolocation function to create a custom mirror pool from countries within the geolocated continent.

The --continent argument is using a geolocation function to create a custom mirror pool from countries within the geolocated continent.

Instead of pacman-mirrors probing all mirrors in all countries it is possible to supply a list of countries from which to use the mirrors. This creates a custom mirror pool. The countries is an example - check the country list if in doubt.

Instead of pacman-mirrors probing all mirrors in all countries it is possible to supply a list of countries from which to use the mirrors. This creates a custom mirror pool. The countries is an example - check the country list if in doubt.

If a supplied country does not offer a mirrorserver the app quits with an error explaining why.

If a supplied country does not offer a mirrorserver the app quits with an error explaining why.

  .: Info Downloading mirrors from repo.manjaro.org

  .: Info Downloading mirrors from repo.manjaro.org

  .: Warning Option '-c/--country' : unknown country: 'Antarctica'

  .: Warning Option '-c/--country' : unknown country: 'Antarctica'

Another option for the mirrors closest to your location is '''--geoip'''

Another option for the mirrors closest to your location is '''--geoip'''

<pre>$ sudo pacman-mirrors --geoip --quiet && sudo pacman -Syyu

<pre>$ sudo pacman-mirrors --geoip --quiet && sudo pacman -Syyu

</pre>

</pre>

If you, for various reasons, have a preference for specific mirrors, it is possible to create a personal mirror pool. This is done by supplying ''--interactive [--default]'', ''--continent-- or ''--country'' argument.

If you, for various reasons, have a preference for specific mirrors, it is possible to create a personal mirror pool. This is done by supplying ''--interactive [--default]'', ''--continent-- or ''--country'' argument.

Don't limit yourself too much. Pacman-mirrors will only use up-to-date mirrors in the final mirrorlist. Also observe this: Your custom mirror pool will not be changed - even if a mirror leaves service or becomes unmaintained. It is your reponsibility to maintain your custom mirror pool in the event the official mirrorpool is changed.

Don't limit yourself too much. Pacman-mirrors will only use up-to-date mirrors in the final mirrorlist. Also observe this: Your custom mirror pool will not be changed - even if a mirror leaves service or becomes unmaintained. It is your reponsibility to maintain your custom mirror pool in the event the official mirrorpool is changed.

The customized pool is saved as <code>/var/lib/pacman-mirrors/custom-mirrors.json</code>

The customized pool is saved as <code>/var/lib/pacman-mirrors/custom-mirrors.json</code>

'''First option''' is using ''--interactive''. It uses your current mirror pool(whether default or custom)

'''First option''' is using ''--interactive''. It uses your current mirror pool(whether default or custom)

  $ sudo pacman-mirrors --interactive && sudo pacman -Syyu

  $ sudo pacman-mirrors --interactive && sudo pacman -Syyu

'''Second option''' is using ''--interactive --default''. This force the use of the official mirror pool

'''Second option''' is using ''--interactive --default''. This force the use of the official mirror pool

  $ sudo pacman-mirrors --interactive --default && sudo pacman -Syyu

  $ sudo pacman-mirrors --interactive --default && sudo pacman -Syyu

'''Third option''' is supplying a list of countries with ''--country''. The countries is an example - check the country list if in doubt.

'''Third option''' is supplying a list of countries with ''--country''. The countries is an example - check the country list if in doubt.

  $ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syyu

  $ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syyu

'''Fourth option''' is ''--continent''. The countries used is determined by the continent they are assigned to and can optionally be combined with '''--interactive'''.

'''Fourth option''' is ''--continent''. The countries used is determined by the continent they are assigned to and can optionally be combined with '''--interactive'''.

  $ sudo pacman-mirrors --continent [--interactive]

  $ sudo pacman-mirrors --continent [--interactive]

Using ''--interactive'' option, pacman-mirrors will process the available mirrors and present you with a list in which you will select your desired mirrors. In any case the pool is saved and used to generate a mirrorlist.

Using ''--interactive'' option, pacman-mirrors will process the available mirrors and present you with a list in which you will select your desired mirrors. In any case the pool is saved and used to generate a mirrorlist.

Pacman-mirrors downloads pool status for the default mirror pool. When you want to regenerate your mirrorlist, your custom pool is updated with the info from the downloaded pool status.

Pacman-mirrors downloads pool status for the default mirror pool. When you want to regenerate your mirrorlist, your custom pool is updated with the info from the downloaded pool status.

This ensures you will '''always''' use up-to-date mirrors.

This ensures you will '''always''' use up-to-date mirrors.

'''First option''' to reset is to default mirror pool

'''First option''' to reset is to default mirror pool

'''Second option''' to is to use ''--default'' with ''--interactive'' and creating a new custom mirror pool

'''Second option''' to is to use ''--default'' with ''--interactive'' and creating a new custom mirror pool

* You will be presented with a list with all and every mirror and you can pick your selection.

* You will be presented with a list with all and every mirror and you can pick your selection.

'''Third option''' is to supply a list of countries and use those for a custom mirror pool.

'''Third option''' is to supply a list of countries and use those for a custom mirror pool.

The countries is an example - check the country list if in doubt.

The countries is an example - check the country list if in doubt.

* If you supply the same preferred countries on every reset you will get your mirror pool updated with added or removed mirrors.

* If you supply the same preferred countries on every reset you will get your mirror pool updated with added or removed mirrors.

The '''--continent''' option has a behavior similar to '''--country'''

The '''--continent''' option has a behavior similar to '''--country'''

  sudo pacman-mirrors --country all --api --protocol all -set-branch stable && sudo pacman -Syyu

  sudo pacman-mirrors --country all --api --protocol all -set-branch stable && sudo pacman -Syyu

The system will throw messages about newer packages on the system. These messages can safely be ignored and they dissappear when the installed package(s) equals the system branch.

The system will throw messages about newer packages on the system. These messages can safely be ignored and they dissappear when the installed package(s) equals the system branch.

* The manpage is in section 8 (System administration commands)

* The manpage is in section 8 (System administration commands)

* [https://gitlab.manjaro.org/applications/pacman-mirrors/tree/master/docs man page]

* [https://gitlab.manjaro.org/applications/pacman-mirrors/tree/master/docs man page]

If pacman-mirrors is updated and has a new '''pacman-mirrors.conf''', it will inform you that a new conf is saved as '''pacman-mirrors.conf.pacnew'''.

If pacman-mirrors is updated and has a new '''pacman-mirrors.conf''', it will inform you that a new conf is saved as '''pacman-mirrors.conf.pacnew'''.

''You must manually merge changes/additions into your pacman-mirrors.conf.''

''You must manually merge changes/additions into your pacman-mirrors.conf.''

* [https://forum.manjaro.org/search?q=pacman-mirrors%20order%3Alatest Pacman-mirrors in the forum]

* [https://forum.manjaro.org/search?q=pacman-mirrors%20order%3Alatest Pacman-mirrors in the forum]

</translate>

</translate>