Private Packages

dot can build and publish mapped private packages into a private pacman repository, and register the repo include in pacman.conf.

Register the private repo

dot setup-private-repo

Syncs the private Arch package repo mirror, writes the private pacman repo snippet, and adds the Include line to /etc/pacman.conf when it is missing. This repairs Omarchy pacman.conf refreshes that remove local repository includes. Privileged writes prefer pkexec and fall back to sudo.

Publish a package

dot private-pkg-publish <package-name>
dot private-pkg-publish <package-name> --install
dot private-pkg-publish --skip-build --no-git <package-name>

Builds and publishes a mapped private package into the private pacman repo, syncs the mirror, refreshes pacman metadata, optionally installs it, and commits/pushes by default.

Flag	Effect
--no-git	Skip the package repo commit and push.
--skip-build	Publish an existing dist package artifact.
--install	Install the published package after syncing the mirror.

Configuration

Private package sources and the repo config live in the private overlay:

• DOT_PRIVATE_PACKAGE_REPO_FILE — private pacman repo config (default $DOTFILES_PRIVATE_DIR/.dot-private-package-repo).
• DOT_PRIVATE_PACKAGES_FILE — private package list (default $DOTFILES_PRIVATE_DIR/.dot-private-packages).
• DOT_PRIVATE_PACMAN_REPO_CONFIG — pacman repo snippet path written by dot (default /etc/pacman.d/timmo-private.conf).

See Environment Variables for the full list.