Skip to main content

Switch noVNC keyboard from QWERTY to AZERTY

Set your VPS OS to AZERTY so the noVNC console, SSH, and RDP all use the correct keyboard layout.

Andy Wallace avatar
Written by Andy Wallace
Updated over a month ago

The noVNC console uses whatever keyboard layout is configured inside your VPS. It does not follow your physical keyboard automatically. To switch from QWERTY to AZERTY, update the keyboard settings inside your Linux or Windows VPS.


Set AZERTY on Linux (Ubuntu or Debian)

Open the noVNC console from your LumaDock dashboard, or connect by SSH if you prefer.


Run the keyboard configuration tool:

sudo dpkg-reconfigure keyboard-configuration

Follow the prompts:

  • Keep the default keyboard model unless you need something specific.

  • Select a layout such as French (AZERTY) or Belgian (AZERTY).

Apply the changes:

sudo service keyboard-setup restart \
sudo service console-setup restart \
# or
sudo reboot

After rebooting, noVNC, local TTY, and SSH connections will all use AZERTY.


Set AZERTY on Windows Server

Open the noVNC console and update the Windows keyboard layout.


Steps:

  1. Go to Start → Settings → Time & Language → Language & Region.

  2. Select Add a language and choose French (France) or French (Belgium).

  3. Open Options and add an AZERTY keyboard.

  4. Set the AZERTY layout as the default input method.

Typing in noVNC now matches AZERTY, and RDP sessions will also use the new layout.


Optional — noVNC toolbar keyboard

Some noVNC sessions offer a keyboard icon in the toolbar. You can select an AZERTY layout here, but this is temporary and may reset after reconnecting or restarting the server.
Use OS-level configuration for a permanent fix.


Quick workaround (local OS)

If you only need a temporary fix, you can switch your local machine’s layout to match the VPS. noVNC forwards keystrokes directly, so aligning both layouts avoids mismatches.


Troubleshooting

  • If Linux still uses QWERTY, rerun the configuration wizard and reboot.

  • If Windows types QWERTY, remove extra layouts and keep only the AZERTY keyboard.

  • If characters look incorrect, verify your local OS layout toggle.

  • For special key combinations like Ctrl+Alt+Del, use the noVNC "Send Keys" menu.


Setting the layout inside your VPS ensures consistent behavior across noVNC, SSH, and RDP.

Did this answer your question?