8,560
edits
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
Line 10: | Line 10: | ||
=== Use === | === Use === | ||
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. pacman-mirrors will selfupdate by downloading mirrors.json and status.json from repo.manjaro.org | ||
# repo.manjaro.org | |||
# wikipedia.org | # wikipedia.org | ||
# bitbucket.org | # bitbucket.org | ||
Line 27: | Line 27: | ||
{{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.}} | ||
$ sudo pacman - | $ sudo pacman -Syu | ||
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] | ||
Line 65: | Line 65: | ||
====Update mirrorlist with the fastest mirrors==== | ====Update mirrorlist with the fastest mirrors==== | ||
sudo pacman-mirrors --fasttrack && sudo pacman - | sudo pacman-mirrors --fasttrack && sudo pacman -Syu | ||
====Limit to 5 mirrors==== | ====Limit to 5 mirrors==== | ||
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 - | sudo pacman-mirrors --fasttrack 5 && sudo pacman -Syu | ||
====Mirrors for your country only==== | ====Mirrors for your country only==== | ||
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 - | sudo pacman-mirrors --geoip && sudo pacman -Syu | ||
===Commands customizing the mirror pool=== | ===Commands customizing the mirror pool=== | ||
Line 82: | Line 82: | ||
====Customize mirror pool by continent==== | ====Customize mirror pool by continent==== | ||
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 - | sudo pacman-mirrors --continent && sudo pacman -Syu | ||
====Customize mirror pool by countries==== | ====Customize mirror pool by countries==== | ||
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 - | sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu | ||
====Customize mirror pool by interactive selection==== | ====Customize mirror pool by interactive selection==== | ||
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 - | sudo pacman-mirrors --interactive --default && sudo pacman -Syu | ||
====Use specific protocols (prioritized)==== | ====Use specific protocols (prioritized)==== | ||
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 - | sudo pacman-mirrors --api --protocol https,http && sudo pacman -Syu | ||
====Switch branch to unstable and use German mirrors==== | ====Switch branch to unstable and use German mirrors==== | ||
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 - | sudo pacman-mirrors --country Germany --api --set-branch unstable && sudo pacman -Syu | ||
==== Switch branch and use German mirrors with https==== | ==== Switch branch and use German mirrors with https==== | ||
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 - | sudo pacman-mirrors --country Germany --api --set-branch unstable --protocol https && sudo pacman -Syu | ||
===Reset=== | ===Reset=== | ||
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 | ||
sudo pacman-mirrors --country all --api --protocols all --set-branch stable && sudo pacman - | sudo pacman-mirrors --country all --api --protocols all --set-branch stable && sudo pacman -Syu | ||
==Overview== | ==Overview== | ||
Line 1,950: | Line 1,950: | ||
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. | ||
$ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman - | $ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu | ||
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. | ||
$ sudo pacman-mirrors --country Antarctica && sudo pacman - | $ sudo pacman-mirrors --country Antarctica && sudo pacman -Syu | ||
.: 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' | ||
Line 1,966: | Line 1,966: | ||
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 - | <pre>$ sudo pacman-mirrors --geoip --quiet && sudo pacman -Syu | ||
:: Querying servers, this may take some time | :: Querying servers, this may take some time | ||
=> Testing mirrors in France | => Testing mirrors in France | ||
Line 1,983: | Line 1,983: | ||
'''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 - | $ sudo pacman-mirrors --interactive && sudo pacman -Syu | ||
'''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 - | $ sudo pacman-mirrors --interactive --default && sudo pacman -Syu | ||
'''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 - | $ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu | ||
'''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'''. | ||
Line 2,004: | Line 2,004: | ||
'''First option''' to reset is to default mirror pool | '''First option''' to reset is to default mirror pool | ||
$ sudo pacman-mirrors --country all && sudo pacman - | $ sudo pacman-mirrors --country all && sudo pacman -Syu | ||
'''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 | ||
$ sudo pacman-mirrors --interactive --default && sudo pacman - | $ sudo pacman-mirrors --interactive --default && sudo pacman -Syu | ||
* 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. | ||
$ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman - | $ sudo pacman-mirrors --country Germany,France,Austria && sudo pacman -Syu | ||
* 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. | ||
Line 2,019: | Line 2,019: | ||
=== Apply pacman-mirrors defaults === | === Apply pacman-mirrors defaults === | ||
sudo pacman-mirrors --country all --api --protocol all -set-branch stable && sudo pacman - | sudo pacman-mirrors --country all --api --protocol all -set-branch stable && sudo pacman -Syu | ||
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. |