AppArmor profiles for various programs and services on Arch Linux.
Table of contents:
These AppArmor profiles are tested on the following hardware:
- CPUs:
- Intel 8250U
- AMD Ryzen 5600x, 5800x3D, EPYC 7601
- GPUs:
- AMD 7900 XTX with amdgpu mesa/kernel driver
- Intel 620 UHD Graphics with i915 mesa/kernel driver
- Network adapters:
- Intel Wireless-AC 9260, Wi-Fi 6 AX200
- Realtek RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller
- Virtio virtual ethernet card
- Bluetooth adapters:
- Intel Wireless-AC 9260, Wi-Fi 6 AX200
I cannot guarantee that these profiles will work on any other hardware. All profiles should work with Sway on AMD and Intel hardware. At this time I no longer have access to NVIDIA hardware nor the desire to maintain support for their proprietary driver.
These profiles strive to be fully functional with zero audit log warnings under normal usage. Functionality is not ignored. If functionality is not explicitly blocked, then it's probably a bug in the profile and should be fixed. Create an issue: https://github.com/krathalan/apparmor-profiles/issues
You should read through the notes before using these profiles.
Get krathalans-apparmor-profiles-git from the AUR: https://aur.archlinux.org/packages/krathalans-apparmor-profiles-git/
To add rules to the profiles without changing the files provided by this repository, use local overrides. See less /etc/apparmor.d/local/README for more details. You can see commented examples of local overrides in the local/ directory in this repository.
Please file bug reports, requests, etc. at https://github.com/krathalan/apparmor-profiles/issues
Writing AppArmor profiles is fairly easy. "If you know how to use bash, chmod, and grep, you already understand AppArmor and you can probably reverse-engineer the policy by yourself," at 13:25 in the video: https://invidio.us/watch?v=k3kerBRYLhw
Pull requests and issues are welcome. I cannot test for hardware I do not have access to (AMD), so those PRs would be most critical.
To get started writing AppArmor profiles, I highly recommend this video from openSUSE: https://invidio.us/watch?v=o2xa8JYcrmw
You may also find this document incredibly helpful: https://gitlab.com/apparmor/apparmor/wikis/AppArmor_Core_Policy_Reference
- bluetoothd
- haveged
- iwd
- less
- mosh
- pipewire
- postgrey
- rngd
- signal-desktop
- spamc
- systemd-networkd
- systemd-resolved
- wl-copy-paste
- wlsunset
- wob
If you use a program like GNU stow to manage your dotfiles via symlinks, you may run in to issues using these AppArmor profiles. You will need to add local overrides to allow that program to access the real location of your config file(s) that the symlink(s) point to. For example, I keep my dotfiles at ~/documents/config/... and use stow to keep them in ~/.config. For the polybar profile, I have the file /etc/apparmor/local/polybar with the following snippet:
# Config file at ~/.config/polybar/config is a symlink to this file
owner @{HOME}/documents/config/xorg-config/.config/polybar/config r,
See adding local overrides for more information.
- irssi
- khard
- mako
- micro
- mpv
- transmission-cli
- vdirsyncer
- waybar
The only directory (apart from program-specific config or data directories, such as those in ~/.config) in the home directory that these profiles are allowed to read and write to is ~/{D,d}ownloads/. You won't be able to, for example, upload things to the web from your ~/Documents directory. You'll need to copy the file to your ~/{D,d}ownloads/ directory first, or add local overrides.
- chromium
- firefox
- transmission-cli
You can find more information for the specific profile by clicking on its name. You may not have to add any local overrides, however -- many profiles work with the default configurations for that program.
- chromium
- evince
- Firefox
- imv
- khard
- mbsync
- micro
- mpv
- nginx
- pash
- postfix
- radicale
- ssh
- ssh-agent
- streamlink
- swaybg
- syncthing
- transmission-cli
- vdirsyncer
- waybar
This profile has been tested with the ungoogled-chromium AUR package ONLY, on both Xorg and Sway (with --ozone-platform-hint=auto).
You will need to add local overrides if you wish to view documents that are not in ~/{D,d}ocuments/ or ~/{D,d}ownloads/. You will also need to add overrides if you wish to edit or save documents.
This profile has been tested with the firefox and firefox-developer-edition repo packages, on WebRender -- on the aforementioned hardware, on both Xorg and Sway. This single profile will apply to all Firefox versions.
You will need to add local overrides if you wish to view images that are not in ~/{D,d}ownloads/, ~/{P,p}ictures/, or ~/{P,p}hotos/.
You may need to add local overrides to allow khard to access your contact storage directory, if you keep it somewhere other than ~/.local/share/contacts.
You may need to add local overrides to allow mbsync to access your mail storage directories, if they're somewhere other than ~/.local/share/mail/.
Additionally, you may add local overrides to be able to view/edit files in directories other than ~/{D,d}ocuments/ and ~/{G,g}it/.
This profile allows mpv to utilize yt-dlp to stream videos.
This AppArmor profile also works when mpv is invoked by other programs like streamlink. A streamlink profile is also available.
Use the command line flag --gpu-context=wayland for Wayland support. Use the command line flag --hwdec=auto for hardware decoding. You can also tell mpv to always use these options through a config file.
You will need to add local overrides to allow nginx to access your hosted files (e.g. index.html, etc.).
You may need to add local overrides to allow nginx to access your HTTPS certificates, if you keep them somewhere other than /etc/letsencrypt/.
This profile assumes you are running nginx as an unprivileged user via systemd: https://wiki.archlinux.org/index.php/Nginx#Running_unprivileged_using_systemd
You may need to add local overrides to allow pash to access your password files and GNUPG files if they're somewhere other than ~/.local/share/pash/ and ~/.gnupg/ respectively.
You may need to add local overrides to allow postfix to access your HTTPS certificates, if you keep them somewhere other than /etc/letsencrypt/.
These profiles may not work depending on your configuration. Patches accepted.
You may need to add local overrides to allow radicale to access your:
htpasswdfile, if you keep it somewhere other than/etc/radicale/.- storage directory, if you keep it somewhere other than
/var/lib/radicale/. - or HTTPS certificates, if you keep them somewhere other than
/etc/letsencrypt/.
Make sure you check the user/group permissions on your htpasswd file!
This profile will work with mosh, the mobile shell, and with git for interacting with remote repositories. There's an AppArmor profile for mosh in this repository, and these profiles work together.
You may need to add local overrides to allow ssh to access your SSH keys, if you keep them somewhere other than ~/.ssh/.
You may need to add local overrides to allow ssh-agent access to your SSH keys, if you keep them somewhere other than ~/.ssh/.
You will need to set either mpv or vlc as your default player. You must have the separate mpv AppArmor profile from this repository enabled.
You may need to add local overrides to allow swaybg to access your specified wallpaper, if you keep it somewhere other than ~/{P,p}ictures/{W,w}allpapers/.
You will need to add local overrides to allow syncthing to access your synced directories.
This profile applies to all transmission-* binaries, including transmission-daemon and transmission-remote.
You may need to add local overrides to allow vdirsyncer to access your contact storage directory, if you keep it somewhere other than ~/.local/share/contacts.
You may need to add local overrides to allow waybar modules to work which I have not tested. I have tested the following modules to work: sway/workspaces, sway/mode, sway/window, network, pulseaudio, cpu, clock, tray.
- aerc
- code
- cupsd
- discord (-> use flatpak version + flatseal)
- epiphany
- Gedit
- gpg-agent
- Hexchat
- KeepassXC
- Lollypop
- mutt
- nitter
- pass
- pipewire (until it is stable)
- polybar
- pulseaudio
- redshift
- signal-desktop
- wpa_supplicant
- xclip
- xob
- youtube-dl
These are profiles which I used to keep updated with their packaged versions, but now do not -- most likely because:
- They are only used on Xorg and I have moved all of my machines to Wayland, or
- I have found an alternative program (e.g. Hexchat -> irssi) that I have a new AppArmor profile for, or
- I find extremely cumbersome and difficult to maintain an AppArmor profile of, either because the program is extremely complex (e.g. cupsd), or because of other reasons (e.g. epiphany, because it cannot be AppArmor-ed with the WebKit sandbox enabled, and because it changes so frequently and so bizarrely that I find it difficult to keep up), or
- I have stopped using the program for a different reason.
If you wish to maintain one of these profiles please submit patches!
Sometimes I will resurrect these profiles if I see fit (in the case of pipewire).