Manjaro Difference between revisions of "Arch User Repository"

Difference between revisions of "Arch User Repository"

From Manjaro
imported>Verityproductions
imported>Verityproductions
Line 1: Line 1:
= Overview =
= Overview =


{{warning| '''Use the AUR at your own risk!''' Support will not be provided by the Manjaro team for any issues that may arise relating software installations from the AUR. }}
{{warning|'''Use the AUR at your own risk!''' Support will not be provided by the Manjaro team for any issues that may arise relating to software installations from the AUR. }}


Although Manjaro is 100% Arch compatible - being based on Arch itself - it is not possible access the official repositories of the Arch System to download software. Manjaro instead uses its own official repositories in order to ensure that any software packages provided (e.g. system updates and applications) have been fully tested and are completely stable before release.
Although Manjaro is 100% Arch compatible - being based on Arch itself - it is not possible access the official repositories of the Arch System to download software. Manjaro instead uses its own official repositories in order to ensure that any software packages provided (e.g. system updates and applications) have been fully tested and are completely stable before release.
Line 13: Line 13:
* Malicious packages (although extremely rare)  
* Malicious packages (although extremely rare)  


As such, although much (if not most) of the software packages provided by the AUR should work, do not expect the installation process to always be quite as straightforward as when using the official repositories. On occasion, it may be necessary to manually identify and install dependencies yourself after an aborted installation, for example. In addition, there is no guarantee that any installed software will work properly, if at all.
As such, although much of the software packages provided by the AUR should work, do not expect the installation process to always be quite as straightforward as when using the official repositories. On occasion, it may be necessary to manually identify and install dependencies yourself after an aborted installation attempt, for example. In addition, there is no guarantee that any installed software will work properly, if at all.




= Accessing the AUR =
= Accessing the AUR =


Two packages are required in order to access the AUR, which can be installed in the terminal:
Two packages are required in order to access the AUR, which can be installed using the terminal:


'''1. The base-developer group package:''' Rather than downloading pre-compiled software packages for installation, you will instead be downloading the instructions to build and compile them on your system. This group package is therefore required to do this. '''This should be pre-installed on Manjaro 0.8.1 onwards.'''
'''1. The base-developer group package:''' Rather than downloading pre-compiled software packages for installation, you will instead be downloading the instructions for Manjaro to build and compile them on your system. The base-developer group package is required to do this. '''This should be pre-installed on Manjaro 0.8.1 onwards.'''


'''2.''' Either '''yaourt''' or '''packer:''' Either of these are used to search and download from the AUR, rather like pacman is used to search and download from from Manjaro's official repositories. Both will also automatically find and download the necessary dependencies for downloads as well (provided the software packages to be installed properly state which dependencies are needed). Which you may chose is entirely down to personal preference. However, yaourt (an acronym for '''Y'''et '''A'''n'''O'''ther '''U'''ser '''R'''espository '''T'''ool) seems to be the most popular choice for users.
'''2.''' Either '''yaourt''' or '''packer:''' Either of these are used to search and download from the AUR, rather like pacman is used to search and download from from Manjaro's official repositories. Both will also automatically find and download the necessary dependencies for downloads as well, provided that the software packages to be installed properly state which dependencies are needed. Which of these tools you may chose is entirely down to personal preference. However, yaourt (an acronym for '''Y'''et '''A'''n'''O'''ther '''U'''ser '''R'''espository '''T'''ool) seems to be the most popular choice for users.




{{note| Although the base developer group package should already be installed on your system, it will be included in the installation instructions anyway. The worst that can happen is that it will be updated!}}
{{note| Although the base developer group package should already be installed on your system, it will still be included in the installation instructions. The worst that can happen is that it will be updated!}}




Line 39: Line 39:
= Searching for and Installing Software From the AUR =
= Searching for and Installing Software From the AUR =


Both yaourt and packer are automatically configured to search the AUR for software packages; there is no need to configure any files or such after installation to make them work. They are also very similar to pacman to use. Furthermore, as with pacman, it is not necessary to specify precise or complete package names to search for or download packages. For example, if wishing the download the Avant Window Navigator, simply entering 'avant' will yield a list of potential matches to browse and select from.
Both yaourt and packer are automatically configured to search the AUR for software packages; there is no need to configure any files or such after installation to make them work. They are also very similar to pacman to use. Furthermore, as with pacman, it is not necessary to specify precise or complete package names to search for or download packages. For example, if wishing the download the ''Avant Window Navigator'' (a popular dock/toolbar), simply entering 'avant' will yield a list of potential matches to browse and select from.


{{tip|It is '''strongly''' recommended to first visit the AUR website and examine the relevant page(s) for any and all software intended to be installed. These pages contain comments from both users and developers in the community, and may provide information on any issues as well as solutions for potential problems. The AUR website can be found '''here'''}}
{{tip|It is '''strongly''' recommended to first visit the AUR website and examine the relevant page(s) for any and all software intended to be installed. These pages contain comments from both existing users and package developers, which may provide valuable information (e.g. warnings and/or solutions to problems). The AUR website can be found '''[http://aur.archlinux.org/ here]'''}}




Line 47: Line 47:




While the use of the sudo command is a convention when using pacman to install files (e.g. sudo pacman -S [software package name]), it is not necessary with yaourt or packer. Instead, to search for and install software packages from the AUR, the syntax is:
While the use of the ''sudo'' command is a convention when using pacman to install files (e.g. sudo pacman -S [software package name]), it is not necessary to use this with yaourt or packer. Instead, to search for and install software packages from the AUR, the syntax is:


  [yaourt or packer] [software package name]
  [yaourt or packer] [software package name]


As illustrated, a search for the Avant Window Navigator was undertaken using yaourt with the command '''yaourt avant''', resulting in ten possible matches being listed. Any or all of the listed packages would be undertaken by entering their number. For example, entering '''3''' would install the ''avant-window-navigaor-bzr''. Adding '''5''' after this would also install extra applets for it (e.g. enter '''3 5''').
As illustrated, a search for the ''Avant Window Navigator'' was undertaken with yaourt using the command '''yaourt avant'''. This has resulted in ten possible matches being listed. Any combination of listed packages can be downloaded simply by entering their number. For example, entering '''3''' would install the package ''avant-window-navigaor-bzr''. Adding '''5''' after this would also install extra applets for for this package (e.g. '''3 5''').


{{tip| The text at the end of each to will inform you if a package is already installed or out of date, etc. The numbers at the end are user votes. The higher the number, the more popular the package: note that option 5 has the highest number of votes by far!}}
{{tip|The numbers at the end are user votes. The higher the number, the more popular the package: note that option 5 has the highest number of votes by far!}}
<br clear="all" />
<br clear="all" />


Line 59: Line 59:




Once your chosen software packages have been entered, and the installation process has begun, user comments from the AUR website may be displayed if using yaourt, followed by a warning that the package is unsupported and potentially dangerous. This warning is a standard message for for all downloads.  
Once the number(s) of your chosen software package(s) have been entered, and the installation process has begun, user comments from the AUR website may be displayed if using yaourt. You may also be presented with a standard warning that the download package is unsupported and potentially dangerous.  


You may also be asked if you wish to '''Edit PKGBUILD'''. Unless you know what you are doing, always enter '''n''' for ''no'' when asked. The purpose of this option is to allow experienced users to inspect the instructions that will be used to build the package(s) to be installed. As dependencies may also have to be installed first in the process, it is possible to be prompted several times. Just be aware that you will also be prompted to continue the installation as well, so '''make sure you read each prompt properly before entering anything!'''
You may also be asked if you wish to '''Edit PKGBUILD'''. Unless you know what you are doing, always type '''n''' for 'no' when asked. The purpose of this option is to allow experienced users to inspect the instructions that will be used to build the package(s) to be installed. As dependencies may also have to be installed first in the process, it is possible to be prompted several times to do this. Although you should just keep entering 'no' to these prompts, be aware that you will also be prompted on occasion to continue the installation as well. So'''make sure you read each prompt properly before entering anything,''' else you could end up aborting the installation by accident!
<br clear="all" />
<br clear="all" />

Revision as of 17:35, 2 October 2012

Overview

Warning
Use the AUR at your own risk! Support will not be provided by the Manjaro team for any issues that may arise relating to software installations from the AUR.

Although Manjaro is 100% Arch compatible - being based on Arch itself - it is not possible access the official repositories of the Arch System to download software. Manjaro instead uses its own official repositories in order to ensure that any software packages provided (e.g. system updates and applications) have been fully tested and are completely stable before release.

However, it is still possible to access additional software packages from the Arch User Repository (AUR), which is managed by the Arch community (i.e. users) themselves. Although this repository is unofficial, software packages first placed here are known to make their way into Arch's official repositories if they become popular enough. Unfortunately, as a community maintained repository, using the AUR does still present potential risks and problems. These include the AUR providing:

  • Multiple versions of the same packages
  • Out of date packages
  • Broken or only partially working packages
  • Improperly configured packages (e.g. downloading unnecessary dependencies, and/or not downloading necessary dependencies)
  • Malicious packages (although extremely rare)

As such, although much of the software packages provided by the AUR should work, do not expect the installation process to always be quite as straightforward as when using the official repositories. On occasion, it may be necessary to manually identify and install dependencies yourself after an aborted installation attempt, for example. In addition, there is no guarantee that any installed software will work properly, if at all.


Accessing the AUR

Two packages are required in order to access the AUR, which can be installed using the terminal:

1. The base-developer group package: Rather than downloading pre-compiled software packages for installation, you will instead be downloading the instructions for Manjaro to build and compile them on your system. The base-developer group package is required to do this. This should be pre-installed on Manjaro 0.8.1 onwards.

2. Either yaourt or packer: Either of these are used to search and download from the AUR, rather like pacman is used to search and download from from Manjaro's official repositories. Both will also automatically find and download the necessary dependencies for downloads as well, provided that the software packages to be installed properly state which dependencies are needed. Which of these tools you may chose is entirely down to personal preference. However, yaourt (an acronym for Yet AnOther User Respository Tool) seems to be the most popular choice for users.


Note
Although the base developer group package should already be installed on your system, it will still be included in the installation instructions. The worst that can happen is that it will be updated!


  • To install the base developer group package and yaourt, enter the command:
sudo pacman -S base-devel yaourt
  • To install the base developer group package and packer, enter the command:
sudo pacman -S base-devel packer

Once entered, follow the (simple) on-screen prompts to complete the installation process.


Searching for and Installing Software From the AUR

Both yaourt and packer are automatically configured to search the AUR for software packages; there is no need to configure any files or such after installation to make them work. They are also very similar to pacman to use. Furthermore, as with pacman, it is not necessary to specify precise or complete package names to search for or download packages. For example, if wishing the download the Avant Window Navigator (a popular dock/toolbar), simply entering 'avant' will yield a list of potential matches to browse and select from.



Tip
It is strongly recommended to first visit the AUR website and examine the relevant page(s) for any and all software intended to be installed. These pages contain comments from both existing users and package developers, which may provide valuable information (e.g. warnings and/or solutions to problems). The AUR website can be found here


Yaourtsearch.png


While the use of the sudo command is a convention when using pacman to install files (e.g. sudo pacman -S [software package name]), it is not necessary to use this with yaourt or packer. Instead, to search for and install software packages from the AUR, the syntax is:

[yaourt or packer] [software package name]

As illustrated, a search for the Avant Window Navigator was undertaken with yaourt using the command yaourt avant. This has resulted in ten possible matches being listed. Any combination of listed packages can be downloaded simply by entering their number. For example, entering 3 would install the package avant-window-navigaor-bzr. Adding 5 after this would also install extra applets for for this package (e.g. 3 5).



Tip
The numbers at the end are user votes. The higher the number, the more popular the package: note that option 5 has the highest number of votes by far!



Once the number(s) of your chosen software package(s) have been entered, and the installation process has begun, user comments from the AUR website may be displayed if using yaourt. You may also be presented with a standard warning that the download package is unsupported and potentially dangerous.

You may also be asked if you wish to Edit PKGBUILD. Unless you know what you are doing, always type n for 'no' when asked. The purpose of this option is to allow experienced users to inspect the instructions that will be used to build the package(s) to be installed. As dependencies may also have to be installed first in the process, it is possible to be prompted several times to do this. Although you should just keep entering 'no' to these prompts, be aware that you will also be prompted on occasion to continue the installation as well. Somake sure you read each prompt properly before entering anything, else you could end up aborting the installation by accident!

Cookies help us deliver our services. By using our services, you agree to our use of cookies.