Skip to content

Get help

FoundryOS is a young, independent project. There is no commercial support desk — there are docs, a community forming around it, and a system designed to fix itself first.

Start with the built-in recovery

Most "help, it broke" moments on other distros are designed-for events here. Check these before reaching for a human:

A bad update broke something

Reboot and pick the previous snapshot from the boot menu, or open the Snapshots app and restore. The Health app names the likely culprit.

The machine won't boot cleanly

After consecutive unhealthy boots, self-heal routes you to the last known-good snapshot automatically. Health explains what happened afterward.

Something is off but boots fine

Run the Health app, or `foundryos-diagnose` in a terminal — it diffs the system against last-known-good and proposes a reversible fix.

Channels

Documentation

The operator handbook covers day-to-day use and every first-party command; decisions and security are the deeper dives.

Read the docs

IRC — #foundryos on Libera.Chat

Real-time community chat. Ask questions, share hardware reports, and help other users.

Join #foundryos

Bug reports

Found something broken? The reporting guide covers what to include, the one command that gathers redacted evidence, and how AI-assisted reports work.

Report a bug

Security issues

Vulnerabilities get a private channel so they can be fixed before they're public. Please don't file them as ordinary bugs.

security@foundrylinux.com

Want to help the project instead? Support the forge — donations fund the automated verification that keeps the Freshness catalog proven.