Revision as of 08:34, 30 October 2018

Overview

Warning

Use the AUR at your own risk!

No support will be provided by the Manjaro team for any issues that may arise relating to software installations from the AUR.

With Manjaro updates, AUR packages might stop working. This is not a Manjaro issue.

Although Manjaro is very close to Arch Linux and mostly compatible —being based on Arch Linux itself— it is not possible to access their official repositories for use in Manjaro.

Instead, Manjaro uses its own repositories in order to ensure that any software packages that are accessible, such as system updates and applications, have been fully tested to be compatible and stable before release.

It is still possible to access additional software packages from the Arch User Repository (AUR).

The AUR is managed by the Arch Linux user community itself. Although this repository is unofficial, software packages first placed here can eventually make their way into Arch Linux's official (community) repository if they become popular enough.

AUR, as a community maintained repository, present potential risks and problems.

Possible risks using AUR packages:

Multiple versions of the same packages.
Out of date packages.
Broken or only partially working packages.
Improperly configured packages which download unnecessary dependencies, or do not download necessary dependencies, or both.
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 straight-forward as when you are using the official Manjaro repositories.

On occasion, it may be necessary to manually identify and install dependencies yourself (such as, after an aborted installation attempt).

Again, there is no guarantee that any installed software will work properly, if at all.

Accessing the AUR

1. Pamac GUI: graphical application Add/Remove Software application named Pamac.

2. Pamac CLI: command line tool pamac build aur-pkg-name.

(Note for Octopi users: Octopi can only use trizen or yaourt to access the AUR.)

Using GUI Pamac

Open Pamac - the name in menu is Add/Remove Software and navigate to the Preferences page. You will be required to enter your password to access it.

At Preferences page → seleetc the AUR tab → and move the slider to enable AUR.

'To access AUR from Octopi: You need to turn it on in Tools → Options → AUR. Then Octopi will include the green alien head. Click on it, enter your search term, and hit enter to search the AUR.

Using commandline Pamac

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 (such as, warnings and/or solutions to problems).

The AUR website can be found here

Yay must be used in the terminal and is itself very similar to pacman to use; furthermore, as with pacman, it is not necessary to specify precise or complete package names in order to search for or download software. To search for and install software packages from the AUR, the syntax is:

pamac search -a [software package name]

For example, if wishing to install Visual Studio Code AUR version (a popular source code editor) enter visual studio as the query and a list of potential matches is shown. To build the example with pamac enter the following and press enter

pamac build visual-studio-code-bin

You will be presented with the outcome of the chosen build with all dependencies and you will be asked a couple of questions.

1. Query to edit build files. This is a precaution to verify that the build scripts does not contain malicious actions. 2. Query to continue download and install dependencies then download the sources, build and install the app.

You will be asked for your password before anything happens.

Installing from the AUR by hand

Manual

To do that follow the steps given below:

Be sure you have the necessary files for building applications from source

pamac install base-devel git

Download the tarball from the AUR preferably to ~/Downloads

(just click on the tarball from your browser and you should get it)

Make a sub-directory in downloads called builds:

mkdir ~/Downloads/builds

-- Move the tarball to builds (Note that foo is a placeholder for the actual name of the package you've downloaded):

mv foo.tar.gz builds

-- Change directory to the builds folder-

cd builds

-- Untar the tarball

tar -xvf foo.tar.gz

-- Move into the new sub-directory

cd <foo>

To make/compile the package, run:

makepkg -s

This will build the package and pull in any dependencies needed. Note: it won't pull a dependency from the AUR, only from the Manjaro Repos.

If you run

ls

you'll probably find a few new files. You're interested in the one that ends with .pkg.tar.xz (usually)

The final event is running $sudo pacman -U on that file-

sudo pacman -U foo.pkg.xz

And you've done it...the safest way to install from the AUR.

This is essentially what most install scripts do for you.

Note: Instead of using sudo pacman -U foo.pkg.xz can also use:

makepkg -i

Note: To combine above steps into one:

makepkg -is

You can ask for support for installing by hand at the following link-[1]

(Courtesy bloomode for the tutorial).

Upgrading the packages installed from the AUR

The following command will upgrade all packages on the system including AUR builds

pamac upgrade -a

@@ Line 1: / Line 1: @@
 = 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. }}
+{{warning|'''Use the AUR at your own risk!'''
-Although Manjaro is one-hundred percent Arch Linux compatible &mdash;being based on Arch Linux itself&mdash; it is not possible to access their official repositories for use in Manjaro. Instead, Manjaro uses its own repositories in order to ensure that any software packages that are accessible, such as system updates and applications, have been fully tested and are stable before release.
+'''No support''' will be provided by the Manjaro team for any issues that may arise relating to software installations from the AUR.
-With that said, it is still possible to access additional software packages from the ''[https://wiki.archlinux.org/index.php/AUR Arch User Repository]'' (AUR). The AUR is managed by the Arch Linux user community itself. Although this repository is unofficial, software packages first placed here can ultimately make their way into Arch Linux's official (community) repository if they become popular enough. '''Unfortunately, as a community maintained repository, using the AUR does still present potential risks and problems.''' Risks, such as, the AUR providing:
+With Manjaro updates, AUR packages might stop working. This is not a Manjaro issue.}}
+Although Manjaro is very close to Arch Linux and mostly compatible &mdash;being based on Arch Linux itself&mdash; it is not possible to access their official repositories for use in Manjaro.
+Instead, Manjaro uses its own repositories in order to ensure that any software packages that are accessible, such as system updates and applications, have been fully tested to be compatible and stable before release.
+It is still possible to access additional software packages from the ''[https://wiki.archlinux.org/index.php/AUR Arch User Repository]'' (AUR).
+The AUR is managed by the Arch Linux user community itself. Although this repository is unofficial, software packages first placed here can eventually make their way into Arch Linux's official (community) repository if they become popular enough.
+'''AUR, as a community maintained repository, present potential risks and problems.'''
+Possible risks using AUR packages:
 * Multiple versions of the same packages.
@@ Line 11: / Line 23: @@
 * Broken or only partially working packages.
 * Improperly configured packages which download unnecessary dependencies, or do not download necessary dependencies, or both.
-* Malicious packages (although extremely rare) .
+* 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 straight-forward as when you are using the official Manjaro repositories. On occasion, it may be necessary to manually identify and install dependencies yourself (such as, after an aborted installation attempt). Again, there is no guarantee that any installed software will work properly, if at all.
-= Accessing the AUR =
+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 straight-forward as when you are using the official Manjaro repositories.
-'''The AUR can be accessed with the GUI tools Pamac and Octopi (via trizen). This is the easiest way for beginners. '''
+On occasion, it may be necessary to manually identify and install dependencies yourself (such as, after an aborted installation attempt).
-The necessary software needed to access and use the AUR within a terminal:
+'''Again, there is no guarantee that any installed software will work properly, if at all.'''
-'''1. The base-developer group of packages:''' 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-devel'' package is required to do this.
+= Accessing the AUR =
-'''2. Pamac CLI:''' pamac command line tool ''pamac build aur-pkg-name''
+. Pamac GUI: graphical application '''Add/Remove Software''' application named '''Pamac'''.
-'''3. Aur Helper''': ''yay'', ''aurman'', or ''trizen''.  These are used to search and download from the AUR, rather like '''[[pacman]]''' is used to search and download from Manjaro's official repositories. Just like ''pacman'' it will also automatically find and download the necessary dependencies for downloaded software as well, provided that the software packages themselves have properly stated which dependencies are needed. Please see [https://wiki.archlinux.org/index.php/AUR_helpers this comparison table] of Aur helpers to help you choose one.
+. Pamac CLI: command line tool '''pamac build aur-pkg-name'''.
 (<u>Note for Octopi users</u>: Octopi can only use ''trizen'' or ''yaourt'' to access the AUR.)
-To install the base-developer group and yay, enter the following command in your terminal:
+== Using GUI [[Pamac]] ==
+Open Pamac - the name in menu is ''Add/Remove Software'' and navigate to the Preferences page. You will be required to enter your password to access it.
+At Preferences page &rarr; seleetc the AUR tab &rarr; and move the slider to enable AUR.
- sudo pacman -S base-devel yay
+'''To access AUR from [[Octopi]]'':
+You need to turn it on in Tools &rarr; Options &rarr; AUR. Then [[Octopi]] will include the green alien head. Click on it, enter your search term, and hit enter to search the AUR.
+== Using commandline [[Pamac]] ==
-To access AUR from [[Octopi]]:
+{{tip|It is '''strongly''' recommended to first visit the [http://aur.archlinux.org/ AUR website] and examine the relevant page(s) for any and all software intended to be installed.
-You need to turn it on in Tools -> Options -> AUR. Then [[Octopi]] will include the green alien head. Click on it, enter your search term, and hit enter to search the AUR.
-= Searching for and Installing Software From the AUR =
+These pages contain comments from both existing users and package developers, which may provide valuable information (such as, warnings and/or solutions to problems).
-{{tip|It is '''strongly''' recommended to first visit the [http://aur.archlinux.org/ 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 (such as, warnings and/or solutions to problems). The AUR website can be found '''[http://aur.archlinux.org/ here]'''}}
+The AUR website can be found '''[http://aur.archlinux.org/ here]'''}}
 Yay must be used in the terminal and is itself very similar to pacman to use; furthermore, as with pacman, it is not necessary to specify precise or complete package names in order to search for or download software. To search for and install software packages from the AUR, the syntax is:
-  yay [software package name]
+  pamac search -a [software package name]
-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. While the use of the ''sudo'' command is a convention when using pacman to install files (for example: sudo pacman -S [software package name]), it is '''not necessary''' to use this with yay.
+For example, if wishing to install ''Visual Studio Code'' AUR version (a popular source code editor) enter ''visual studio'' as the query and a list of potential matches is shown. To build the example with '''pamac''' enter the following and press enter
-  yay avant
+  pamac build visual-studio-code-bin
-[[File:yaourtsearch.png|thumb|left|375px]]
+You will be presented with the outcome of the chosen build with all dependencies and you will be asked a couple of questions.
-As illustrated, a search for the ''Avant Window Navigator'' undertaken has resulted in ten possible matches being listed. Any combination of listed packages can be downloaded by simply entering their numbers. 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:
+. Query to edit build files. This is a precaution to verify that the build scripts does not contain malicious actions.
+. Query to continue download and install dependencies then download the sources, build and install the app.
- '''==> Enter No of packages to be installed (ex: 1 2 3 or 1-3)'''
+You will be asked for your password before anything happens.
- '''==> -------------------------------------------------------'''
-5
-{{tip|The numbers at the end of each line are user votes for each package. The higher the number, the more popular the package. Note that option '3' has the highest number of votes by far!}}
-<br clear="all" />
-[[file:yaourtdownload.png|thumb|left|375px]]
-Once the number(s) of your chosen software package(s) have been entered, and the installation process has begun, you may 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 to edit these as well.
-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" />
 = Installing from the AUR by hand =
-==Packages from the AUR can also be installed ''by hand'' (manually)==
+== Manual ==
 To do that follow the steps given below:
+* Be sure you have the necessary files for building applications from source
+ pamac install base-devel git
 * Download the tarball from the AUR preferably to ''~/Downloads''
 (just click on the tarball from your browser and you should get it)
 * Make a sub-directory in downloads called builds:
   mkdir ~/Downloads/builds
--- Move the tarball to builds (foo is the name of the package you've downloaded):
+-- Move the tarball to builds (Note that foo is a placeholder for the actual name of the package you've downloaded):
   mv foo.tar.gz builds
@@ Line 107: / Line 113: @@
   sudo pacman -U foo.pkg.xz
 And you've done it...the safest way to install from the AUR.
 This is essentially what most install scripts do for you.
@@ Line 114: / Line 119: @@
   makepkg -i
+''Note:'' To combine above steps into one:
+ makepkg -is
 You can ask for support for installing by hand at the following link-[http://forum.manjaro.org/index.php?topic=7076.msg61520#msg61520]
@@ Line 121: / Line 129: @@
 = Upgrading the packages installed from the AUR =
-The following command will upgrade '''all''' packages downloaded from the AUR [https://github.com/Jguer/yay/pull/624].
+The following command will upgrade '''all''' packages on the system including AUR builds
-  yay -Sua
+  pamac upgrade -a
-=See Also=
+= See Also =

Difference between revisions of "Arch User Repository"