Advanced Fcitx5 setup on Linux
Open the section that matches what you see after installation. If you are still setting up Funput, start with the Fcitx5 setup steps.
What do you need to check?
Settings are missing after signing back in
Try restarting the computer once. The service that reads environment.d can stay active after you sign out, so it may not have reloaded the file.
If fcitx5-diagnose still reports missing variables, check where your session reads settings.
- GNOME with GDM or Plasma 5.22 and later. Use
~/.config/environment.d/fcitx5.confwhen the session reads settings from the systemd user manager. - Bash login sessions. Bash looks for
~/.bash_profile, then~/.bash_login, then~/.profile, and reads only the first one that exists. Add the lines withexportto that file. For example, Fedora and Arch usually ship~/.bash_profile, while Ubuntu usually has only~/.profile. If none of them exists, create~/.bash_profile. - Settings for multiple users. An administrator can use
/etc/profileon systems that read that file at login.
Set each variable in one place. If you use a different login shell, check which file it reads and follow its syntax. Fcitx5 documentation on environment variables
Vietnamese typing works except in a Qt app on Wayland
If Funput works in a text editor but fails in a Qt app, check which desktop you use.
- KDE Plasma. Try an app-specific setting before changing the whole session.
- GNOME or sway. For applications using Qt 6.8.2 or later, add this line to
~/.config/environment.d/fcitx5.conf.
QT_IM_MODULES=wayland;fcitx
The new name ends in S. If you set it in a Bash file instead of environment.d, add quotes, because ; has its own meaning in Bash: export QT_IM_MODULES="wayland;fcitx". Keep QT_IM_MODULE=fcitx if Qt 5 or older Qt 6 applications still need it. Sign out and back in to test. Fcitx5 documentation for Qt on Wayland
Use your distribution’s setup tool on X11
If your session check shows x11, use the tool for your distribution.
- Debian, Ubuntu and derivatives. Run
im-config -n fcitx5. To make the selection in a window, runim-configand choose fcitx5. - Fedora. Run
sudo dnf install fcitx5-autostart. - Arch, openSUSE or another distribution. Open the X11 setup instructions.
Using Wayland? Choose the setup for your desktop.
The suggestion window flickers on KDE Wayland
Check whether GTK_IM_MODULE or QT_IM_MODULE is set for the whole session.
- If you used
im-config, open it and choose the desktop default. If you added the variables manually, remove those lines from the file you edited. - Apply the Fcitx5 setup for KDE Wayland.
If only one XWayland application needs QT_IM_MODULE, set it for that application. For example, if the command to open WPS Writer is wps:
env QT_IM_MODULE=fcitx wps
Reload Fcitx5 on KDE Wayland
If you enabled Fcitx5 in System Settings → Virtual Keyboard, save your work, sign out and sign back in. KDE connects the input method at login. Running fcitx5 -r or choosing Restart in the tray can break that connection until the next login.
See which settings Fcitx5 loaded
After signing back in, open Terminal and run:
fcitx5-diagnose
The output shows the variables and input methods Fcitx5 loaded. If Funput is selected but typing still fails, see Troubleshooting.