If you mean the physical Linux console, loadkeys is the right tool when the keymap is installed; if you mean SSH or the browser terminal, the keyboard layout is normally controlled by the computer you are typing from. That distinction explains why standard Debian locale commands may not behave as expected on ZimaOS.
ZimaOS does not currently document a persistent keyboard-layout setting in its UI. The forum suggestion loadkeys fr is technically valid for a Linux virtual console, but it was not confirmed as a persistent ZimaOS configuration.
Physical Console vs Web Terminal
A keyboard plugged directly into the ZimaOS machine uses the Linux console keymap. A browser terminal or SSH session receives characters from the client OS, so changing the server's console keymap usually will not change how your laptop keyboard behaves there.
Try loadkeys on the Local Console
loadkeys fr
loadkeys de
loadkeys ukThe upstream Linux loadkeys manual explains that loadkeys changes the kernel keymap for virtual consoles.
Check Which Keymaps Are Available
If loadkeys fr returns “cannot open file,” the keymap files may not be included in the ZimaOS image. Do not download random system keymaps into protected OS paths as a first step.
SSH Uses the Client Keyboard Layout
If you SSH from a French, German, Spanish, or Nordic laptop, set the layout on Windows, macOS, or Linux locally. SSH transmits the resulting characters; it does not normally translate physical key positions on the server.
Browser Terminal Also Uses the Browser Client
For the ZimaOS web terminal, check the host computer's layout and browser behavior before changing Linux console maps. Test punctuation such as /, :, -, and symbols you need in commands.
Do Not Use localectl as a ZimaOS Assumption
Commands such as localectl are common on systemd desktop/server distributions but are not guaranteed to manage keyboard layout on an appliance-style image.
Persistent Changes Need an Official Mechanism
A manual loadkeys change can affect the current console but may not survive a reboot in the way you expect. Since current ZimaOS docs do not expose a persistent layout control, avoid modifying boot scripts unless support specifically recommends it.
The terminal troubleshooting guide provides broader diagnostic context.
Test the Layout Before Entering Passwords
After changing a physical-console keymap, type a harmless line containing letters, numbers, punctuation, and symbols before entering passwords or destructive commands. Characters such as z/y, slash, colon, pipe, and braces move significantly between common layouts.
Keep an SSH Recovery Session Open
If you are experimenting on a local console, keep a working remote shell open from another computer. A wrong keymap can make local correction awkward, while the remote session remains unaffected because its keyboard mapping is client-side.
FAQ
Will loadkeys fr change my SSH keyboard?
No. SSH keyboard mapping is normally determined by the client computer.
Why do Debian keyboard commands fail?
ZimaOS is not a general-purpose Debian installation and may not include the same locale/keymap tooling.
Can I make the layout persistent?
No current first-party ZimaOS setting was found for that; test manual console keymaps without altering boot scripts.
How do I reset a bad console keymap?
Use a known keymap such as loadkeys us or reconnect through SSH/web terminal if local typing becomes difficult.
