Report an issue

Something not working?

Tell us where you saw it. Each part of airOS has its own issue tracker on GitHub: choose one below to open a short form for a new issue.

Where did you see the problem?

General systemStarting up and installing, drivers and hardware, graphics, Wi-Fi, Bluetooth, sound, the desktop, system updates, and the preferences and system apps.

Office Suite

WordCraftairos-works/wordcraftGridCraftairos-works/gridcraftPDFCraftairos-works/pdfcraftDeckCraftairos-works/deckcraft

Media Tools

AirTimeairos-works/airTimeAmpairos-works/ampPhotoCraftairos-works/photocraftLightCraftairos-works/lightcraftVectorCraftairos-works/vectorcraftEffectCraftairos-works/effectcraftFilmCraftairos-works/filmcraft

Developer

VS Code (Code - OSS)airos-works/vscodepgAdmin 4airos-works/auroraGitHub Desktopairos-works/desktopDocker Desktopairos-works/docker-desktopBurrowairos-works/burrow

Summit Browser

SummitBrowser and WebKit engine

Proton

Proton VPNairos-works/proton-vpn-airos-appProton Mail Bridgeairos-works/proton-bridge

Everyday

Clipperairos-works/clipperAirShotairos-works/airShotAirImagerairos-works/airimager

System

Media preferencesairos-works/haikuMediaConverterairos-works/haikuBluetooth preferencesairos-works/haikuWi-Fi preferencesairos-works/haikuScreen preferencesairos-works/haikuQuick Look in Trackerairos-works/haikuNetwork shares in Trackerairos-works/haikuMailairos-works/mailTerminalairos-works/haiku

What to have ready

The form asks for three things. A short, specific report is the most useful.

  • A brief description. What you did, what happened, and what you expected instead.
  • Your hardware platform and details. The machine or board, processor, graphics and memory, and your airOS release: run cat /boot/system/data/airos/release in Terminal, or note the image you installed from. For a driver problem, listdev or listusb shows the device.
  • Anything that shows the problem. When an app crashes, choose Save report in the dialog: the .report file is saved on your Desktop. The system log is /var/log/syslog. A screenshot helps too. Drag files into the form to attach them.

You need a free GitHub account to open an issue. Issues are public, so leave out passwords, keys and personal details, including in logs and screenshots.