Skip to content

Document PIHOLE_SELINUX environment variable - #1413

Open
TomPi-22 wants to merge 1 commit into
pi-hole:masterfrom
TomPi-22:document-pihole-selinux-var
Open

Document PIHOLE_SELINUX environment variable#1413
TomPi-22 wants to merge 1 commit into
pi-hole:masterfrom
TomPi-22:document-pihole-selinux-var

Conversation

@TomPi-22

@TomPi-22 TomPi-22 commented Aug 2, 2026

Copy link
Copy Markdown

What does this PR aim to accomplish?:

Documents the PIHOLE_SELINUX environment variable, which is currently undocumented anywhere on docs.pi-hole.net although it is present in the current basic-install.sh. Provides a reference for users who encounter the installer's SELinux Enforcing exit.

Fixes #316

How does this PR accomplish the above?:

Added a new "SELinux" section to docs/main/update.md. It explains that pihole -up will exit if SELinux is detected in Enforcing mode, and documents how setting PIHOLE_SELINUX=true before running the update skips that check.

Link documentation PRs if any are needed to support this PR:

N/A


By submitting this pull request, I confirm the following:

  1. I have read and understood the contributors guide, as well as this entire template. I understand which branch to base my commits and Pull Requests against.
  2. I have commented my proposed changes within the code and I have tested my changes.
  3. I am willing to help maintain this change if there are issues with it later.
  4. It is compatible with the EUPL 1.2 license
  5. I have squashed any insignificant commits. (git rebase)
  6. I have checked that another pull request for this purpose does not exist.
  7. I have considered, and confirmed that this submission will be valuable to others.
  8. I accept that this submission may not be used, and the pull request closed at the will of the maintainer.
  9. I give this submission freely, and claim no ownership to its content.

  • I have read the above and my PR is ready for review. Check this box to confirm

Signed-off-by: TomPi-22 <tom.a.cocker@gmail.com>
@TomPi-22
TomPi-22 requested a review from a team as a code owner August 2, 2026 19:53
@netlify

netlify Bot commented Aug 2, 2026

Copy link
Copy Markdown

Deploy Preview for pihole-docs ready!

Name Link
🔨 Latest commit 5d99e54
🔍 Latest deploy log https://app.netlify.com/projects/pihole-docs/deploys/6a6fa03dfff73f0008bad586
😎 Deploy Preview https://deploy-preview-1413--pihole-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document hidden PIHOLE_SELINUX variable

1 participant