1Byte Systems

Chapter 10 · 1B Dock guide

Troubleshooting: common problems and their solutions

Find what you see below; the texts in bold are the ones in the app.

Check this first

On Linux, 1B Dock needs KDE Plasma 6 in a Wayland session: it doesn't work on GNOME, on other desktops or in an X11 session. On Windows, Windows 10 or 11, 64-bit. The bottom of the settings window says The dock is running or The dock is not running.

Go back to the KDE panel or the Windows taskbar

KDE: turn off Show the top bar if you used it, then right-click the desktop › Enter Edit Mode › Add Panel to put a panel back (or show the one you hid). To remove the dock, remove the 1B Dock package; your panels were never deleted.

Windows: right-click the dock and choose Show the Windows Taskbar, or Quit 1B Dock. Uninstalling 1B Dock also brings the taskbar back.

Start from scratch

In About › Advanced, Restore defaults › Restore puts every setting back as it was. Pinned apps are kept. Settings file opens the plain text file where everything is saved.

Problems and solutions

The dock doesn't appear

Check that you're in KDE Plasma 6 with a Wayland session (on the login screen, choose Plasma (Wayland)). Open 1B Dock from the app menu: it doesn't start by itself until you add it to Autostart.

The dock doesn't start when I log in

On KDE, add 1B Dock in System Settings › Autostart. On Windows the installer already does this.

I see two bars at the top

If you already have a panel at the top in Plasma you will see both: remove it (or hide it) in Plasma’s Edit Mode.

An app doesn't show its menu in the bar

Only KDE and Qt apps export their menu; the others show just their name. Apps that were already open before you turned on the bar show it after you open them again. Check that Global app menu is on.

The update didn't install

On KDE the system asks for your password: if you cancel it, nothing changes and the notice says so. Try Install and Restart again, or download the new version from the 1B Dock page.

SmartScreen warns me on Windows

The installer isn't signed yet. Choose More info › Run anyway. The updates downloaded by the app itself don't show this warning.

The weather says “No connection”

The widget needs the Internet to ask our weather server. Check your connection; the dock keeps working without it.

For 1B Dock 0.4 on KDE Plasma 6 (Wayland) and Windows 10 and 11.