arcanis/ahriman
1
0
Fork 0
mirror of https://github.com/arcan1s/ahriman.git synced 2025-04-24 07:17:17 +00:00
Code Issues Projects Releases Wiki Activity
720edc24ba
ahriman/docs/setup.md
Evgeniy Alekseev 04174a3e6d deprecate init/repo-init command 
In current workflow you need to run setup to run init (because of
repository name), but you need to run init before setup (because of
repository tree rights).

New solution just add `Repo.init()` method call to setup subcommand
after config reload to make sure that repository name has been applied.
In addition chown method as well as setuid method for check_output have
been added.
2022-03-21 01:32:11 +03:00

2.6 KiB
Raw Blame History

Setup instructions

  1. Install package as usual.

  2. Change settings if required, see configuration reference for more details.

  3. TL;DR

    sudo ahriman -a x86_64 repo-setup ...

    repo-setup literally does the following steps:

    1. Create /var/lib/ahriman/.makepkg.conf with makepkg.conf overrides if required (at least you might want to set PACKAGER):

      echo 'PACKAGER="John Doe <john@doe.com>"' | sudo -u ahriman tee -a /var/lib/ahriman/.makepkg.conf

    2. Configure build tools (it is required for correct dependency management system):

      1. Create build command, e.g. ln -s /usr/bin/archbuild /usr/local/bin/ahriman-x86_64-build (you can choose any name for command, basically it should be {name}-{arch}-build).
      2. Create configuration file, e.g. cp /usr/share/devtools/pacman-{extra,ahriman}.conf (same as previous pacman-{name}.conf).
      3. Change configuration file, add your own repository, add multilib repository etc;
      4. Set build_command option to point to your command.
      5. Configure /etc/sudoers.d/ahriman to allow running command without a password.
      ln -s /usr/bin/archbuild /usr/local/bin/ahriman-x86_64-build
cp /usr/share/devtools/pacman-{extra,ahriman}.conf

echo '[multilib]' | tee -a /usr/share/devtools/pacman-ahriman.conf
echo 'Include = /etc/pacman.d/mirrorlist' | tee -a /usr/share/devtools/pacman-ahriman.conf

echo '[aur-clone]' | tee -a /usr/share/devtools/pacman-ahriman.conf
echo 'SigLevel = Optional TrustAll' | tee -a /usr/share/devtools/pacman-ahriman.conf
echo 'Server = file:///var/lib/ahriman/repository/$arch' | tee -a /usr/share/devtools/pacman-ahriman.conf

echo '[build]' | tee -a /etc/ahriman.ini.d/build.ini
echo 'build_command = ahriman-x86_64-build' | tee -a /etc/ahriman.ini.d/build.ini

echo 'Cmnd_Alias CARCHBUILD_CMD = /usr/local/bin/ahriman-x86_64-build *' | tee -a /etc/sudoers.d/ahriman
echo 'ahriman ALL=(ALL) NOPASSWD: CARCHBUILD_CMD' | tee -a /etc/sudoers.d/ahriman
chmod 400 /etc/sudoers.d/ahriman

  4. Start and enable ahriman@.timer via systemctl:

    systemctl enable --now ahriman@x86_64.timer

  5. Start and enable status page:

    systemctl enable --now ahriman-web@x86_64

  6. Add packages by using ahriman package-add {package} command:

    sudo -u ahriman ahriman -a x86_64 package-add ahriman --now

User creation

user-add subcommand is recommended for new user creation.