Difference between revisions of "Arch User Repository"

general reformatting and proofreading
imported>Cscs
(Clean and reorganize. Add octopi to Contents Links)
(general reformatting and proofreading)
Line 1: Line 1:
= Overview =
= Overview =
{{BoxWarning|Use the AUR at your own risk!|


{{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. When Manjaro is updated, AUR packages might stop working. '''This is not a Manjaro issue'''}}
 
'''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.  
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.  
Line 33: Line 30:


= 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.
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 AUR tab → and move the slider to enable AUR.
At Preferences page → select the AUR tab → and move the slider to enable AUR.


== Using commandline [[Pamac]] ==
== Using commandline [[Pamac]] ==
 
{{Important|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.  
{{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).  
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]'''}}
To search for and install software packages from the AUR, the syntax is:
To search for and install software packages from the AUR, the syntax is:
  pamac search -a [software package name]
  pamac search -a [software package name]


For example, if wishing to install ''Vivaldi'' enter ''vivaldi'' as the query and a list of potential matches is shown. To build the example with '''pamac''' enter the following and press enter
For example, if wishing to install ''Vivaldi'' enter ''vivaldi'' 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 vivaldi
  pamac build vivaldi


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.
1. 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.
 
# You will be asked for your password before anything happens.
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.


== 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.


<br clear="all" />
==Installing from the AUR by hand==
 
===Manual===
= Installing from the AUR by hand =
 
== 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
  pamac install base-devel git
  pamac install base-devel git
 
* Clone the PKGBUILD
* Download the tarball from the AUR preferably to ''~/Downloads''
git clone https://aur.archlinux.org/foo.git
(just click on the tarball from your browser and you should get it)
* Change directory to cloned folder
 
  cd foo
* 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:
* To make/compile the package, run:
  makepkg -s
  makepkg -s
Line 102: Line 69:
''Note: it won't pull a dependency from the AUR, only from the Manjaro Repos.''
''Note: it won't pull a dependency from the AUR, only from the Manjaro Repos.''


If you run   
If you run list the content of the foler
  ls
  ls
you'll probably find a few new files. You're interested in the one that ends with .pkg.tar.xz (usually)
you'll probably find a few new files. You're interested in the one that ends with .pkg.tar.zst
 


* The final event is running $sudo pacman -U on that file-
* The final event is running $sudo pacman -U on that file-
  sudo pacman -U foo.pkg.xz
  sudo pacman -U foo.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.


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


''Note:'' To combine above steps into one:
''Note:'' To combine above steps into one:
  makepkg -is  
  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]
==Upgrading the packages installed from the AUR==
 
(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
The following command will upgrade '''all''' packages on the system including AUR builds
  pamac upgrade -a
  pamac upgrade -a


= See Also =
==See Also==
 
* [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 Pacman]
 
[http://wiki.manjaro.org/index.php?title=Pacman_Tips Pacman Tips]
 
 


[[Category:Contents Page]]
[[Category:Contents Page]]
[[Category:Software Management]]
[[Category:Software Management]]
Moderators, translator
424

edits