diff --git a/modules/default-flatpaks/README.md b/modules/default-flatpaks/README.md
index f45c363..355a189 100644
--- a/modules/default-flatpaks/README.md
+++ b/modules/default-flatpaks/README.md
@@ -2,6 +2,18 @@
 
 The `default-flatpaks` module removes the Fedora Flatpaks remote that comes pre-installed by Fedora, and can be used to install flatpaks from a configurable remote on first boot. Flatpaks can either be installed system-wide or per-user, though per-user flatpaks will be installed for every user on a system. Previously-installed flatpaks can also be removed.
 
+The module uses the following scripts to handle flatpak setup:
+
+- `/usr/bin/system-flatpak-setup`
+- `/usr/bin/user-flatpak-setup`
+
+The scripts are run on first boot and login by these services:
+
+- `/usr/lib/systemd/system/system-flatpak-setup.service`
+- `/usr/lib/systemd/user/user-flatpak-setup-service`
+
+`system-flatpak-setup` checks the flatpak repo information and install/remove lists created by the module. It also checks for the existence of `/etc/ublue-os/system-flatpak-configured` before running. `user-flatpak-setup` functions the same for user flatpaks, but checks for `$HOME/.config/ublue-os/user-flatpak-configured` instead.
+
 Flatpak setup can be run again by removing `/etc/ublue-os/system-flatpak-configured` for system-wide flatpaks, or `$HOME/.config/ublue-os/user-flatpak-configured` for user flatpaks.
 
 ## Example configuration