Linux
Open Engineering on Linux
Open Engineering software is built for Linux as well as Windows, as native programs rather than Windows apps in a wrapper. This page covers what each project needs and how well it is tested.
Projects on Linux
OpenDraft on Linux
OpenDraft runs on X11 and Wayland and is tested in CI on six distributions. Linux gets the same attention as Windows.
Install
The .deb, AppImage and archive are built on Ubuntu 22.04, so they need glibc 2.35 or newer.
| How | Good for |
|---|---|
| .deb | Debian, Ubuntu, Mint. sudo apt install ./OpenDraft-<version>-linux-amd64.deb adds the menu entry, icons and the .odx file type. |
| AppImage | Any distribution, no root. Make it executable (chmod +x) and run it. |
| Archive | Anything else. linux.tar.gz holds opendraft and opendraft-mcp side by side. |
| From source | Developers. cargo build --release -p od-app -p od-mcp |
| Arch and Flatpak | Build files are in the repository and built in CI, but not yet published to the AUR or Flathub. |
What it needs
OpenDraft opens these libraries when it starts, so a bare system must have them. Desktop installations almost always do. On Debian, Ubuntu and Mint:
libgl1-mesa-dri libegl1 libgl1 libx11-6 libx11-xcb1 libxcb1 libxcursor1 libxi6
libxkbcommon0 libxkbcommon-x11-0 libwayland-client0 libwayland-cursor0 libwayland-egl1- File dialogs (Open, Save As) need xdg-desktop-portal with a backend for your desktop (xdg-desktop-portal-gtk, -kde, -gnome…), or zenity. Every mainstream desktop already has a portal.
- Package lists for Fedora, Arch and openSUSE are in the Linux notes in the repository.
What is tested
Every change is built once on Ubuntu 22.04, and that same program is run on the distributions below. On X11 the test starts the real program, opens a drawing, checks the screen is drawn, types L, clicks twice and Enter to draw a line, undoes it with Ctrl+Z, and checks the assistant connection. On Wayland it starts, draws, opens the drawing and closes cleanly. The release workflow also installs the .deb on a bare Ubuntu 22.04 and runs the same checks against it, and starts the AppImage there.
| Distribution | X11 | Wayland | Scaling |
|---|---|---|---|
| Ubuntu 22.04 | Yes | ||
| Ubuntu 24.04 | Yes | Yes | 1.5 and 2 |
| Debian 12 | Yes | ||
| Fedora | Yes | Yes | 2 |
| Arch | Yes | Yes | |
| openSUSE Tumbleweed | Yes |
What is not tested
These runs use a virtual display with software rendering. They do not cover real GPUs, desktop environments or physical printers.
- Real graphics hardware: drivers, GPUs, multiple monitors and variable refresh.
- Real desktop environments. GNOME and KDE have their own window handling and decorations.
- Keyboard and mouse on Wayland, real file dialogs, the clipboard, drag and drop and input methods.
- Printing to paper. The CUPS backend is tested against a cups-pdf queue on Ubuntu 22.04. No real printer or its driver has been tried.
- Pixel-for-pixel appearance. The tests check that the screen is drawn, not that it matches a reference image.
If something does not work
- It does not start, or closes at once. Run it from a terminal and read the last line. If graphics fail, install the Mesa packages above, or try LIBGL_ALWAYS_SOFTWARE=1 opendraft.
- Open or Save As does nothing. Install xdg-desktop-portal and a backend for your desktop, or zenity. Meanwhile, start it with a file name: opendraft drawing.dxf.
- The window is the wrong size on a high-resolution screen. On X11 force a scale: WINIT_X11_SCALE_FACTOR=1.5 opendraft.
- To force X11 in a Wayland session: env -u WAYLAND_DISPLAY opendraft. To force Wayland: env -u DISPLAY opendraft.
- Settings, recent files, autosave copies and crash.log live in ~/.local/share/opendraft. Delete the folder to start afresh.
Reporting a problem
Please include your distribution and version, X11 or Wayland (echo $XDG_SESSION_TYPE), your desktop environment, your graphics hardware or “virtual machine”, how you installed OpenDraft, what you did, what you expected and what happened. Add the terminal output if you started it from a terminal, and crash.log if there is one. A screenshot helps.
Help us test on real machines
The biggest gap in our Linux testing is real hardware. If you run GNOME or KDE, Wayland with a real GPU, an odd graphics stack or a real printer, try it and tell us what happens. A report that says “works on Fedora 41, KDE, Wayland, AMD” is genuinely useful.