Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arkanosis/arkonf
Arkanosis' configuration files
https://github.com/arkanosis/arkonf
configuration dotfiles emacs emacs-configuration linux saltstack zsh zshrc
Last synced: 6 days ago
JSON representation
Arkanosis' configuration files
- Host: GitHub
- URL: https://github.com/arkanosis/arkonf
- Owner: Arkanosis
- License: other
- Created: 2009-09-15T13:26:25.000Z (about 15 years ago)
- Default Branch: master
- Last Pushed: 2024-09-20T07:20:30.000Z (13 days ago)
- Last Synced: 2024-09-22T20:01:45.559Z (11 days ago)
- Topics: configuration, dotfiles, emacs, emacs-configuration, linux, saltstack, zsh, zshrc
- Language: Emacs Lisp
- Homepage: https://arkanosis.net/
- Size: 9.54 MB
- Stars: 20
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Arkonf
Arkonf is a system configuration including:
* a list of packages to install, managed using Salt;
* a collection of configuration files for these tools.
## Installation
## As regular user on any POSIX OS
This will only install configuration files for the current user.
```sh
git clone https://github.com/Arkanosis/Arkonf.git
make -C Arkonf install
```
## As root
This is the prefered way to install the full Arkonf (including packages).
Before anything else, the host name must be set properly. All hosts will get
the base packages and configuration, but only some hosts will get additional
packages, depending on which roles are associated to their names in the pillar.
```sh
hostnamectl set-hostname $HOSTNAME
```
Also, make sure that the name (and the FQDN) is correct in `/etc/hosts` as it
will be used by some packages (such as the MTA).
### On any supported distro (with a bootstrap script)
```sh
wget https://arkanosis.net/bootstrap
chmod a+x bootstrap
./bootstrap
```
### On Arch Linux
```sh
pacman -S salt git
git clone https://github.com/Arkanosis/Arkonf.git /root/Arkonf
ln -s /root/Arkonf/saltstack/salt /srv/salt
ln -s /root/Arkonf/saltstack/pillar /srv/pillar
salt-call --local state.highstate
pacman -Syu
```
### On Debian
```sh
wget https://repo.saltproject.io/salt/py3/debian/11/amd64/latest/SALT-PROJECT-GPG-PUBKEY-2023.gpg -O /usr/share/keyrings/salt-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/salt/py3/debian/11/amd64/latest bullseye main" > /etc/apt/sources.list.d/salt.list
apt update
apt install salt-minion git
systemctl disable --now salt-minion
git clone https://github.com/Arkanosis/Arkonf.git /root/Arkonf
ln -s /root/Arkonf/saltstack/salt /srv/salt
ln -s /root/Arkonf/saltstack/pillar /srv/pillar
apt update
salt-call --local state.highstate
apt upgrade
```
## Application of individual states
Individual states may rely on custom grains and custom modules, which
must be synchronized.
```sh
salt-call --local saltutil.sync_all
```
Afterwards, indidual states can be applied.
```sh
salt-call --local state.sls mail
```
Synchronization of custom grains and custom modules is done automatically when
running`state.highstate`, so there's no need to run `saltutil.sync_all` when
applying the highstate.
## Copyright
Arkonf is copyright (C) 2001-2023 Jérémie Roquet and
all code except code written by third-parties licensed under the ISC license.
See the [LICENSE](/LICENSE) file for more details.
## Links
* https://arkanosis.net/
* https://github.com/Arkanosis/Arkonf