The Windows installer does nothing
It is waiting for administrator permission. Look for the Windows prompt behind your other windows, or click the flashing shield on the taskbar.
Windows says the app is unrecognised
SmartScreen warns because the builds are not code-signed yet. Choose More info, then Run anyway. You can check the file against SHA256SUMS.txt on the release first.
The search hotkey does not open search
Another app owns it. The search bar shows which hotkey BE-Aero fell back to. Set your own in Settings > Search & general.
An app or file is missing from search
The index rebuilds every 30 minutes. Type aero:reindex, or use Rebuild search index in the tray.
GNOME shows no tray icon
Stock GNOME has no system tray. Use the toolbar's menu button, or install the AppIndicator extension.
The Linux dock shows no windows or titles
On GNOME, enable the helper with gnome-extensions enable be-aero-dock@be-ai-research, then log out and back in. On X11, install wmctrl and xprop. Settings shows which window source is active.
Now Playing is empty on Linux
Install playerctl. Volume uses wpctl or pactl.
Something is off on my Linux desktop
Run be-aero-desktop --doctor. It prints the session type, display map and a capability report to paste into a bug report.
The assistant is silent for a long time
A local model may be loading, or the server is busy with another model. After 45 seconds the status line says why. If another model is holding the server, the chat offers Unload and continue. Stop is always safe.
The assistant stopped part-way through a job
It reached the tool-step limit for one message and answered from what it had. Raise the limit in Settings > AI assistant, or ask it to continue.
A local model ignores tools
Some models have no reliable native tool support. BE-Aero switches to text tool calls automatically. You can force either mode in Settings > AI assistant > Tool call format.
My API key was refused
Saving a key checks it by listing the provider's models. A refused key says so plainly. Use Get a key to open the provider's key page and paste a fresh one.
The pairing code does not work
A code lasts 5 minutes and 5 tries. Show a new one. If the two devices cannot see each other, use Pair by address and check that TCP 41801 (or 41811 for a relay) is not blocked by a firewall.
A device shows offline after my router restarted
Its address changed. Devices on the same network find each other again. Otherwise set the new one in Settings > Devices > Address…
The relay's VPN says standby
The hub needs root once. Run sudo be-aero-relay tunnel on the relay. be-aero-relay status says why it is waiting.
I cannot reach my relay away from home
Forward TCP 41811 on your router to the relay machine, and UDP 51820 for the VPN hub.
Two devices changed the same file
Nothing is lost. The File Pool keeps the other version beside it as a conflict copy. Relay Shared storage keeps a copy named with the device and date.
A feature on this site is not in my install
The public downloads serve Desktop 1.2.9 and Relay 1.0.2. The Android suite, realtime sync, the VPN hub, WebGPU and the network tile arrive with 1.3.0, which is built and not yet published.
Realtime sync will not start on my phone away from home
The phone needs a direct connection or the VPN for realtime sync and cross-device tools. The relay mailbox for offline delivery is not on Android yet. Turn on the VPN in the phone's settings.
Is there a macOS or iOS version?
No. BE-Aero runs on Windows 10 and 11, Linux on X11 or XWayland, and Android 12 and later.
Does it work on Wayland?
Not natively. On a Wayland desktop BE-Aero runs through XWayland. On GNOME, enable the dock helper so the dock can see your windows.
WebGPU does nothing in a web frame
Check the WebGPU setting: Automatic, On or Off. On Linux it is opt-in and experimental. On a machine with two graphics cards, try the frame's Fast GPU option.
A web widget shows a certificate warning
The page uses a self-signed certificate. Check the fingerprint shown and choose Proceed to trust that exact certificate for that address. If it ever changes, the widget blocks again.
A widget went off-screen or the layout is a mess
Use Reset widget sizes & positions in Settings or the tray. Docked and free-form layouts are stored separately.
Hibernate is greyed out
Windows has hibernation turned off. The power menu shows how to turn it on.
My local app gets 403 from the API
Either you blocked that capability, or the token is being used from a different program than the one that paired. On Windows a token is tied to the executable, so an updated or moved unsigned program must pair again.