{"id":14965352,"url":"https://github.com/arkanosis/arkonf","last_synced_at":"2025-10-25T11:31:38.664Z","repository":{"id":664676,"uuid":"307753","full_name":"Arkanosis/Arkonf","owner":"Arkanosis","description":"Arkanosis' configuration files","archived":false,"fork":false,"pushed_at":"2024-10-25T17:41:54.000Z","size":10022,"stargazers_count":20,"open_issues_count":0,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-10-30T01:03:07.354Z","etag":null,"topics":["configuration","dotfiles","emacs","emacs-configuration","linux","saltstack","zsh","zshrc"],"latest_commit_sha":null,"homepage":"https://arkanosis.net/","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Arkanosis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2009-09-15T13:26:25.000Z","updated_at":"2024-10-25T17:41:58.000Z","dependencies_parsed_at":"2023-02-19T00:31:12.924Z","dependency_job_id":"ec2ea10a-0239-467d-9395-1f19d83a286f","html_url":"https://github.com/Arkanosis/Arkonf","commit_stats":{"total_commits":1568,"total_committers":3,"mean_commits":522.6666666666666,"dds":"0.13201530612244894","last_synced_commit":"c5fa7028d67fa7b39f35226b4436fa8fd65d65a0"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arkanosis%2FArkonf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arkanosis%2FArkonf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arkanosis%2FArkonf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Arkanosis%2FArkonf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Arkanosis","download_url":"https://codeload.github.com/Arkanosis/Arkonf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238128558,"owners_count":19421054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["configuration","dotfiles","emacs","emacs-configuration","linux","saltstack","zsh","zshrc"],"created_at":"2024-09-24T13:34:37.888Z","updated_at":"2025-10-25T11:31:32.746Z","avatar_url":"https://github.com/Arkanosis.png","language":"Emacs Lisp","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arkonf\n\nArkonf is a system configuration including:\n* a list of packages to install, managed using Salt;\n* a collection of configuration files for these tools.\n\n## Installation\n\n## As regular user on any POSIX OS\n\nThis will only install configuration files for the current user.\n\n```sh\ngit clone https://github.com/Arkanosis/Arkonf.git\nmake -C Arkonf install\n```\n\n## As root\n\nThis is the prefered way to install the full Arkonf (including packages).\n\nBefore anything else, the host name must be set properly. All hosts will get\nthe base packages and configuration, but only some hosts will get additional\npackages, depending on which roles are associated to their names in the pillar.\n\n```sh\nhostnamectl set-hostname $HOSTNAME\n```\n\nAlso, make sure that the name (and the FQDN) is correct in `/etc/hosts` as it\nwill be used by some packages (such as the MTA).\n\n### On any supported distro (with a bootstrap script)\n\n```sh\nwget https://arkanosis.net/bootstrap\nchmod a+x bootstrap\n./bootstrap\n```\n\n### On Arch Linux\n\n```sh\npacman -S salt git\ngit clone https://github.com/Arkanosis/Arkonf.git /root/Arkonf\nln -s /root/Arkonf/saltstack/salt /srv/salt\nln -s /root/Arkonf/saltstack/pillar /srv/pillar\nsalt-call --local state.highstate\npacman -Syu\n```\n\n### On Debian\n\n```sh\nwget https://repo.saltproject.io/salt/py3/debian/11/amd64/latest/SALT-PROJECT-GPG-PUBKEY-2023.gpg -O /usr/share/keyrings/salt-archive-keyring.gpg\necho \"deb [signed-by=/usr/share/keyrings/salt-archive-keyring.gpg arch=amd64] https://repo.saltproject.io/salt/py3/debian/11/amd64/latest bullseye main\" \u003e /etc/apt/sources.list.d/salt.list\napt update\napt install salt-minion git\nsystemctl disable --now salt-minion\ngit clone https://github.com/Arkanosis/Arkonf.git /root/Arkonf\nln -s /root/Arkonf/saltstack/salt /srv/salt\nln -s /root/Arkonf/saltstack/pillar /srv/pillar\napt update\nsalt-call --local state.highstate\napt upgrade\n```\n\n## Application of individual states\n\nIndividual states may rely on custom grains and custom modules, which\nmust be synchronized.\n\n```sh\nsalt-call --local saltutil.sync_all\n```\n\nAfterwards, indidual states can be applied.\n\n```sh\nsalt-call --local state.sls mail\n```\n\nSynchronization of custom grains and custom modules is done automatically when\nrunning`state.highstate`, so there's no need to run `saltutil.sync_all` when\napplying the highstate.\n\n## Copyright\n\nArkonf is copyright (C) 2001-2023 Jérémie Roquet \u003cjroquet@arkanosis.net\u003e and\nall code except code written by third-parties licensed under the ISC license.\n\nSee the [LICENSE](/LICENSE) file for more details.\n\n## Links\n\n* https://arkanosis.net/\n* https://github.com/Arkanosis/Arkonf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farkanosis%2Farkonf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farkanosis%2Farkonf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farkanosis%2Farkonf/lists"}