Test on your distro

Temario is primarily developed on Debian 13 and Ubuntu 26.04, but we want it to work on as many distributions as possible. If you use a different Linux distro, you can help enormously by spending a few minutes running the checks on this page and reporting the result.

Current compatibility status

Distribution	CLI / library	GUI (temario-grafico)
Debian 13 Trixie	✅ Tested	✅ Tested
Ubuntu 26.04 Noble	✅ Tested	✅ Tested
Ubuntu 24.04 Noble	✅ Works	⚠️ PySide6 ≥ 6.7 not in official repos
Fedora 44	🔲 Unconfirmed	🔲 Unconfirmed
Fedora 43	🔲 Unconfirmed	🔲 Unconfirmed
Ubuntu 22.04 Jammy	🔲 Unconfirmed	🔲 Unconfirmed
Linux Mint	🔲 Unconfirmed	🔲 Unconfirmed
openSUSE Tumbleweed	🔲 Unconfirmed	🔲 Unconfirmed
Rocky Linux / AlmaLinux	🔲 Unconfirmed	🔲 Unconfirmed
Arch Linux / Manjaro	🔲 Unconfirmed	🔲 Unconfirmed

Distros marked 🔲 are those that need volunteers most.

What to test

Option A — Install from package (.deb or .rpm)

If your distro is compatible with Debian or Fedora packages, download and install the packages from the packages page and run:

# 1. Check version
temario version

# 2. Build the example course (requires LibreOffice installed)
temario build courses/ejemplo

# 3. Verify the files were generated
ls courses/ejemplo/output/odp/
ls courses/ejemplo/output/pdf/

# 4. (Optional) Launch the graphical interface
temario-grafico

Option B — Install from source

Works on any distro with Python ≥ 3.12:

# 1. System dependencies
sudo apt-get install -y git curl libreoffice poppler-utils   # Debian/Ubuntu
sudo dnf install -y git curl libreoffice poppler-utils       # Fedora

# 2. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.local/bin/env

# 3. Clone and install
git clone https://gitlab.com/pepesan/temario-app temario
cd temario
uv sync

# 4. Test
./temario version
./temario build courses/ejemplo
ls courses/ejemplo/output/

How to report the result

Open an issue on GitLab with the label distro-test and include:

1. Distribution and version — e.g. “Fedora 44 (Workstation)”
2. Installation method — .deb/.rpm package or from source
3. Result of each step — ✅ works / ❌ fails (paste the full error)
4. Python version — python3 --version
5. LibreOffice version — libreoffice --version

Open a testing issue →

No test distro?

You can test in a virtual machine, LXC/LXD container or Docker without reinstalling your system. Any result, even a failure, is useful information.

Highest priority distros right now

Fedora 43 and 44

The .rpm packages are built in CI but have not yet been installed on a real Fedora machine. We need to confirm installation and basic execution.

Ubuntu 24.04

The CLI works. We want to confirm whether the GUI can be installed via an alternative method (pip, uv) or whether the limitation should be documented definitively.

Linux Mint / Pop!_OS

Based on Ubuntu, they probably work, but it is not confirmed. A quick test with the AppImage would be sufficient.

openSUSE / Arch

Installation from source with uv sync. Just need to confirm that Python ≥ 3.12 and LibreOffice are available in their repos.