Difference between revisions of "Pacman-mirrors/en"

Updating to match new version of source page
(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
# github.com
# 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 -Syyu
  $ 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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  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 -Syyu
  $ 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 -Syyu
  $ 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 -Syyu
<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 -Syyu
  $ 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 -Syyu
  $ 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 -Syyu
  $ 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 -Syyu
  $ 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 -Syyu
  $ 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 -Syyu
   $ 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 -Syyu
  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.
8,138

edits