8,595
edits
(Updating to match new version of source page) |
(Updating to match new version of source page) |
||
Line 1: | Line 1: | ||
<languages/> | <languages/> | ||
__TOC__ | __TOC__ | ||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
==Overview== | ==Overview== | ||
{{BoxWarning|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. When Manjaro is updated, AUR packages might stop working. '''This is not a Manjaro issue'''}} | {{BoxWarning|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. When Manjaro is updated, 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 ''[https://wiki.archlinux.org/index.php/AUR Arch User Repository]'' (AUR). | 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 ''[https://wiki.archlinux.org/index.php/AUR Arch User Repository]'' (AUR). | ||
</div> | |||
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. | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
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. | |||
</div> | |||
'''AUR, as a community maintained repository, present potential risks and problems.''' | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
'''AUR, as a community maintained repository, present potential risks and problems.''' | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
Possible risks using AUR packages: | Possible risks using AUR packages: | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
* Multiple versions of the same packages. | * Multiple versions of the same packages. | ||
* Out of date packages. | * Out of date packages. | ||
Line 16: | Line 25: | ||
* Improperly configured packages which download unnecessary dependencies, or do not download necessary dependencies, or both. | * 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). | ||
</div> | |||
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. | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
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. | |||
</div> | |||
On occasion, it may be necessary to manually identify and install dependencies yourself (such as, after an aborted installation attempt). | <div lang="en" dir="ltr" class="mw-content-ltr"> | ||
On occasion, it may be necessary to manually identify and install dependencies yourself (such as, after an aborted installation attempt). | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
'''Again, there is no guarantee that any installed software will work properly, if at all.''' | '''Again, there is no guarantee that any installed software will work properly, if at all.''' | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
{{Important|You should become familiar with the manual build process in order to be prepared to troubleshoot problems.}} | {{Important|You should become familiar with the manual build process in order to be prepared to troubleshoot problems.}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
==Accessing the AUR== | ==Accessing the AUR== | ||
===Using GUI [[Pamac]]=== | ===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 → select the Third Party tab → and move the slider to enable AUR support. Be sure you have the necessary files for building applications from source | 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 → select the Third Party tab → and move the slider to enable AUR support. Be sure you have the necessary files for building applications from source | ||
{{UserCmd|command=pamac install base-devel git}} | {{UserCmd|command=pamac install base-devel git}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
===Using commandline [[Pamac]]=== | ===Using commandline [[Pamac]]=== | ||
{{Important|It is '''strongly''' recommended to follow this link [https://aur.archlinux.org/ AUR website] and examine the relevant page(s) for any and all software intended to be installed.}} | {{Important|It is '''strongly''' recommended to follow this link [https://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). To search for and install software packages from the AUR, the syntax is: | These pages contain comments from both existing users and package developers, which may provide valuable information (such as, warnings and/or solutions to problems). To search for and install software packages from the AUR, the syntax is: | ||
{{UserCmd|command=pamac search -a [software package name]}} | {{UserCmd|command=pamac search -a [software package name]}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
For example, if wishing to install ''Google Chrome'' - first follow this link to '''[https://aur.archlinux.org/packages/?K=google-chrome all Google Chrome build scripts]''' and verify which package you want to build.Or you can ask pamac - for ''Google Chrome'' candidates. Just use the search command and ''Google Chrome'' as the query. Look over the results or narrow the search parameters - just remember pamac cannot tell you of any issues with build scripts - only the relevant page. E.g. following this link to the '''[https://aur.archlinux.org/packages/google-chrome buildscript for Google Chrome]''' | For example, if wishing to install ''Google Chrome'' - first follow this link to '''[https://aur.archlinux.org/packages/?K=google-chrome all Google Chrome build scripts]''' and verify which package you want to build.Or you can ask pamac - for ''Google Chrome'' candidates. Just use the search command and ''Google Chrome'' as the query. Look over the results or narrow the search parameters - just remember pamac cannot tell you of any issues with build scripts - only the relevant page. E.g. following this link to the '''[https://aur.archlinux.org/packages/google-chrome buildscript for Google Chrome]''' | ||
{{UserCmd|command=pamac search Google Chrome}} | {{UserCmd|command=pamac search Google Chrome}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
In the example we choose the standard version of ''Google Chrome''. To build the ''google-chrome'' package with '''pamac''' enter the following and press enter | In the example we choose the standard version of ''Google Chrome''. To build the ''google-chrome'' package with '''pamac''' enter the following and press enter | ||
{{UserCmd|command=pamac build google-chrome}} | {{UserCmd|command=pamac build google-chrome}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
You will be presented with the outcome of the chosen build with all dependencies and you will be asked a couple of questions. | You will be presented with the outcome of the chosen build with all dependencies and you will be asked a couple of questions. | ||
# Query to edit build files. This is a precaution to verify that the build scripts does not contain malicious actions. | # 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. | # 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. | # You will be asked for your password before anything happens. | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
===Using GUI [[Octopi]]=== | ===Using GUI [[Octopi]]=== | ||
See [[Octopi#Accessing_the_AUR|this guide]] for enabling AUR support in Octopi. | See [[Octopi#Accessing_the_AUR|this guide]] for enabling AUR support in Octopi. | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
===Installing from the AUR by hand=== | ===Installing from the AUR by hand=== | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
====Manual==== | ====Manual==== | ||
To do that follow the steps given below: | To do that follow the steps given below: | ||
* Be sure you have the necessary files for building applications from source | * Be sure you have the necessary files for building applications from source | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
{{UserCmd|command=pamac install base-devel git}} | {{UserCmd|command=pamac install base-devel git}} | ||
* Clone the PKGBUILD | * Clone the PKGBUILD | ||
Line 68: | Line 103: | ||
{{UserCmd|command=sudo pacman -U google-chrome-ver.rel.bugfix.build-pkgrel.pkg.zst}} | {{UserCmd|command=sudo pacman -U google-chrome-ver.rel.bugfix.build-pkgrel.pkg.zst}} | ||
And you've done it...the safest way to install from the AUR. This is essentially what most install scripts do for you. | And you've done it...the safest way to install from the AUR. This is essentially what most install scripts do for you. | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
''Note:'' Instead of using ''sudo pacman -U google-chrome-ver.rel.bugfix.build-pkgrel.pkg.zst'' can also use: | ''Note:'' Instead of using ''sudo pacman -U google-chrome-ver.rel.bugfix.build-pkgrel.pkg.zst'' can also use: | ||
{{UserCmd|command=makepkg -i}} | {{UserCmd|command=makepkg -i}} | ||
''Note:'' To combine above steps into one: | ''Note:'' To combine above steps into one: | ||
{{UserCmd|command=makepkg -is}} | {{UserCmd|command=makepkg -is}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
===Upgrading the packages installed from the AUR=== | ===Upgrading the packages installed from the AUR=== | ||
The following command will upgrade '''all''' packages on the system including AUR builds | The following command will upgrade '''all''' packages on the system including AUR builds | ||
{{UserCmd|command=pamac upgrade -a}} | {{UserCmd|command=pamac upgrade -a}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
==See Also== | ==See Also== | ||
* [https://forum.manjaro.org/t/need-to-know-about-manjaro-and-aur/103617 Need to know about Manjaro and AUR] | |||
* [http://wiki.manjaro.org/index.php?title=Pacman Pacman] | * [http://wiki.manjaro.org/index.php?title=Pacman Pacman] | ||
* [http://wiki.manjaro.org/index.php?title=Pacman_Tips Pacman Tips] | * [http://wiki.manjaro.org/index.php?title=Pacman_Tips Pacman Tips] | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
[[Category:Contents Page{{#translation:}}]] | [[Category:Contents Page{{#translation:}}]] | ||
[[Category:Software Management{{#translation:}}]] | [[Category:Software Management{{#translation:}}]] | ||
</div> |