diff options
author | Maxime Poulin | 2016-07-02 00:48:56 -0400 |
---|---|---|
committer | Maxime Poulin | 2016-07-02 00:48:56 -0400 |
commit | 8597f97f8c03d8835b88d4fb897d9e10c0a180fa (patch) | |
tree | 021d415ece696ef5400c9332bf2c850fef153971 /README.md | |
parent | 1cc1d7b47a23ab06c7e9f7422db167527291d7d7 (diff) | |
download | aur-8597f97f8c03d8835b88d4fb897d9e10c0a180fa.tar.gz |
Oops, README.md
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 000000000000..5049b4aad2ef --- /dev/null +++ b/README.md @@ -0,0 +1,57 @@ +# The Lounge's official ArchLinux package + +This is a clone of the repository [already available](https://aur.archlinux.org/packages/thelounge/) on the [AUR](https://wiki.archlinux.org/index.php/Arch_User_Repository). + +This repository is to be used to track ArchLinux's specific issues with this package and allow users to contribute changes to it as well. + +## Installation + +Please follow the usual ArchLinux documentation to install this package fromt he AUR either manually or using your favorite AUR helper. These instructions are only provided as a quick example, but as typical with ArchLinux you are strongly encouraged to read the approprite documentation. + +### Manually +``` +$ git clone https://github.com/thelounge/arch-lounge.git +$ cd arch-lounge +$ # optional: select your release (experimental, master, stable) +$ git checkout stable +$ makepkg +# pacman -U thelounge-*.pkg.* +``` + +### With an AUR helper +with pacaur: +``` +$ pacaur -aS thelounge +``` + +or with yaourt: +``` +$ yaourt -aS thelounge +``` + +### Configuration +The default system-wide documentation file is located at `/etc/thelounge/config.js`. Please note that user profiles and their IRC passwords are also stored there (moving to `/var/lib/thelounge` is planned but not yet done), so the directory is only readable by the `thelounge` user. + +### Running +The Lounge provides both a system-wide and per-user systemd unit. + +#### System +Simply enable the `thelounge.service` unit, and your server should be up and running: + +``` +# systemctl enable --now thelounge.service +``` + +#### User +If you do not want to run the software system-wide, or host multiple users that wish to host their own instance of The Lounge, it can also be launched per user: + +``` +$ systemctl --user enable --now thelounge.service +``` + +Please note that for The Lounge to start on boot in this scenario, you will also require to have [lingering](https://wiki.archlinux.org/index.php/Systemd/User#Automatic_start-up_of_systemd_user_instances) enabled for this user: + +``` +# loginctl enable-linger $username +``` + |