- 1 1. Introduction
- 2 2. Identifying the Cause of Japanese Input Issues
- 3 3. How to Configure the Japanese Input System
- 4 4. Japanese Input Systems Other Than Mozc
- 5 5. Troubleshooting (Solutions)
- 6 6. FAQ (Frequently Asked Questions)
- 6.1 Q1. What should I do if Japanese input suddenly stops working?
- 6.2 Q2. How can I change the Japanese input switching key?
- 6.3 Q3. Japanese input does not work in Chrome only. Why?
- 6.4 Q4. Can I use Japanese input in Ubuntu on WSL (Windows Subsystem for Linux)?
- 6.5 Q5. Conversion candidates or predictive suggestions do not appear in Japanese input.
- 7 7. Summary and Additional Resources
1. Introduction
When using Ubuntu, you may encounter issues such as “Japanese input does not work” or “Keyboard switching does not respond.” This often happens right after a fresh Ubuntu installation or after a system update.
This article explains how to identify the causes of Japanese input not working on Ubuntu and how to reliably enable Japanese input. Even beginners can follow the steps easily, as the procedures are explained in detail.
1.1 What Causes Japanese Input to Stop Working?
To use Japanese input on Ubuntu, you need software called an IME (Input Method Editor). While Windows uses tools such as “Microsoft IME” or “Google Japanese Input,” Ubuntu primarily uses Mozc or Fcitx.
However, Japanese input may not work due to the following reasons:
- The Japanese input system (IME) is not installed
- The IME is not configured correctly (Mozc or Fcitx is not applied)
- The keyboard switching settings are incorrect
- Settings were reset after an Ubuntu version upgrade
- Japanese input is disabled only in certain apps (e.g., Chrome, VS Code)
This article walks you through troubleshooting each of these problems to restore smooth Japanese input.
1.2 What You Will Be Able to Do After Reading This Guide
After reading this article, you will be able to:
- Enable Japanese input on Ubuntu with certainty
- Properly configure Mozc or Fcitx for comfortable Japanese typing
- Troubleshoot issues when Japanese input stops working
- Use keyboard shortcuts to switch input methods efficiently
This guide is written so beginners can follow simple steps without requiring advanced knowledge. Just proceed in order.
2. Identifying the Cause of Japanese Input Issues
There are several reasons why Japanese input may fail on Ubuntu. These can be categorized into four main causes:
- The Japanese input system (IME) is not installed
- The IME is not configured correctly
- Keyboard settings are incorrect
- Japanese input works in some apps but not others
Let’s examine each cause in more detail to identify where the issue lies.
2.1 IME (Japanese Input System) Is Not Installed
To use Japanese input on Ubuntu, an IME must be installed. In most environments, the Japanese input method used is Mozc, developed by Google.
How to Check
Run the following command to verify whether Mozc is installed:
dpkg -l | grep mozcExample results:
- If you see
ii ibus-mozc ...→ Mozc is installed - If nothing appears → Mozc is not installed and must be installed later
If Mozc is not installed, installation steps are provided in a later section.
2.2 IME Is Not Configured Correctly
Even if the IME is installed, Japanese input will not work unless it is configured properly. Ubuntu usually uses IBus as the input method framework that manages IMEs.
Check Current IME Settings
Run the following command to list available input engines:
ibus list-engineExample results:
- If
mozcappears → Mozc is configured - If only
xkb:us::engappears → Mozc may not be applied
If IME settings are incorrect, we will fix it in the next section.
2.3 Incorrect Keyboard Settings
If your keyboard layout is not configured properly, switching to Japanese input may fail.
Check Current Keyboard Layout
Run the following command:
setxkbmap -queryExample result:
layout: jpThis means a Japanese (JIS) keyboard is configured.
layout: usThis means a US keyboard is configured.
If you are using a Japanese keyboard but “us” is set, input may not behave correctly and must be fixed later.
2.4 Japanese Input Does Not Work in Specific Applications
If Japanese input fails only in specific apps (Chrome, VS Code, LibreOffice), those apps may be causing the issue.
How to Check
- Test Japanese input in another app (e.g., Text Editor, Terminal)
- Chrome may allow input in the address bar but not on websites
Solutions for these cases appear later in the troubleshooting section.
3. How to Configure the Japanese Input System
Now that we’ve identified the possible causes, let’s walk through the steps to enable Japanese input in Ubuntu.
The main steps are:
- Install Mozc (Japanese IME)
- Add Mozc to Input Sources
- Configure the input method and verify it works
Follow these steps in order to fix Japanese input reliably.
3.1 Install Mozc
Ubuntu’s default Japanese IME is “Mozc.” If it is not installed, install it with the steps below.
1. Update the System
First update your package list and system:
sudo apt update && sudo apt upgrade -y2. Install Mozc
Then install Mozc:
sudo apt install ibus-mozc -y3. Verify Mozc Installation
Check installation with:
dpkg -l | grep mozcExample output:
ii ibus-mozc 2.23.2815.102-1 amd64 Mozc engine for IBusIf you see similar output, Mozc is successfully installed.
3.2 Add Mozc to Input Sources
Once Mozc is installed, add it to Ubuntu’s input sources.
1. Add Input Source from Settings
- Open Settings
- Select Region & Language
- Click “+” (Add) under Input Sources
- Select Japanese (Mozc) and add it
- Move Mozc to the top to prioritize it
2. Confirm Mozc Setup via Terminal
Check if Mozc is recognized as an input engine:
ibus list-engineExpected Output:
mozcIf displayed, Mozc is active.
3. Restart IBus
Restart IBus to apply changes:
ibus restart3.3 How to Switch Japanese Input
After adding Mozc, verify how to switch Japanese input modes.
1. Keyboard Shortcuts for Switching IME
Default keybindings:
- Hankaku/Zenkaku key (Japanese keyboard)
- Ctrl + Space (US keyboard)
If the “Hankaku/Zenkaku” key does not switch IME, change shortcut settings.
2. Change Input Method Shortcut
- Open Settings
- Select Keyboard Shortcuts
- Search “Switch Input Method”
- Assign a preferred shortcut (e.g., “Super + Space”)
3.4 Verify IME Activation
Check that IME is functioning properly.
1. Verify IME in Terminal
ibus engineExpected Output:
mozcIf displayed, Mozc is functioning.
2. Test Japanese Input in a Text Editor
- Test in “Text Editor (Gedit)” or Terminal
- If you can type “あいうえお,” it is working correctly

4. Japanese Input Systems Other Than Mozc
While Mozc is the recommended default for Ubuntu, you may choose other IMEs such as Fcitx or Anthy depending on your environment.
Examples of when alternatives might be useful:
- Fcitx provides lighter and faster performance than IBus + Mozc
- Anthy works even in environments where Mozc cannot be used
- Useful as a workaround if Mozc fails in some applications
This section explains each IME and how to install them.
4.1 Using Fcitx + Mozc
What is Fcitx?
Fcitx (Flexible Input Method Framework) is a lightweight IME framework that often runs faster than IBus, especially on lower-spec PCs.
How to Install Fcitx
- Install Fcitx and Mozc:
sudo apt update
sudo apt install fcitx fcitx-mozc -y- Set Fcitx as the default input framework:
im-config -n fcitx- Reboot or relogin to apply settings:
reboot- Verify activation:
echo $XMODIFIERSExample Output:
@im=fcitxIf displayed, Fcitx is active.
Configure Fcitx via GUI
- Open Fcitx Configuration Tool (fcitx-config-gtk3)
- In the Input Method tab, add Mozc
- Move Mozc to the top priority
- Restart Fcitx
fcitx restartNow Fcitx + Mozc is fully set up.
4.2 Using Anthy
What is Anthy?
Anthy is an alternative Japanese input engine. While less accurate than Mozc, it is useful in environments where Mozc cannot be installed.
How to Install Anthy
- Install Anthy:
sudo apt install ibus-anthy -y- Add Japanese (Anthy) from Settings → Region & Language → Input Sources
- Restart IBus:
ibus restart- Switch IME to verify operation
Anthy is lightweight but lower in accuracy, useful mainly for minimal environments.
4.3 Comparison: Mozc, Fcitx, and Anthy
| Japanese Input System | Features | Best Use Case |
|---|---|---|
| Mozc (IBus) | Standard IME with high accuracy; Google-developed | General use, beginners |
| Fcitx + Mozc | Lighter and faster than IBus | Low-spec PCs, users who want fast performance |
| Anthy | Lower accuracy but lightweight; works where Mozc does not | Old PCs, special environments |
5. Troubleshooting (Solutions)
Even with the correct settings, Japanese input may still fail. Try the following troubleshooting steps.
5.1 Mozc Does Not Input Japanese
If Mozc does not work even after installation and configuration, check the following:
1. Check Whether Mozc Is Installed
dpkg -l | grep mozcIf not installed, reinstall:
sudo apt install --reinstall ibus-mozc -y2. Check Whether Mozc Is Active
ibus engineExpected Output:
mozcIf not, activate manually:
ibus engine mozc3. Restart Input Method
ibus restartRebooting the PC may also help.
5.2 Japanese Input Not Working in Specific Applications (Chrome, VS Code, etc.)
If Japanese input works in some apps but not others, try the following solutions.
1. If Japanese Input Does Not Work in Google Chrome
Chrome may fail to handle IME properly on certain web pages.
- You can input in the address bar but not within web pages
- Solution: Disable Hardware Acceleration
- Enter
chrome://settings/in the address bar - Open “Advanced Settings” → “System”
- Turn off “Use hardware acceleration when available”
- Restart Chrome
2. If Japanese Input Fails in VS Code
Certain accessibility settings may cause IME not to work.
- Solution: Change Accessibility Settings
- Press
Ctrl + Shift + Pto open the Command Palette - Search
Preferences: Configure Language Specific Settings... - Set
editor.accessibilitySupporttooff - Restart VS Code
5.3 Japanese Conversion Is Slow or Lagging
If Japanese typing feels slow, adjusting Mozc settings can improve performance.
1. Open Mozc Settings
ibus-setupRecommended performance tweaks:
- Disable “Suggestions (Predictive Conversion)”
- Disable “Dictionary Learning”
- Reduce the number of candidates displayed to around 5
These changes lighten Mozc’s processing and improve responsiveness.
5.4 Japanese Input Stops Working After Ubuntu Version Upgrade
Upgrading Ubuntu may reset IME-related settings.
1. Reset IBus Settings
dconf reset -f /desktop/ibus/
ibus restart2. Reinstall Mozc
sudo apt install --reinstall ibus-mozc -y3. Check Environment Variables
Run the following to verify IME settings:
echo $GTK_IM_MODULE
echo $QT_IM_MODULE
echo $XMODIFIERSExpected Output:
GTK_IM_MODULE=ibus
QT_IM_MODULE=ibus
XMODIFIERS=@im=ibusIf incorrectly set, fix them:
export GTK_IM_MODULE=ibus
export QT_IM_MODULE=ibus
export XMODIFIERS=@im=ibus
ibus restart5.5 Japanese Input Suddenly Stops Working
If Japanese input suddenly becomes unavailable, restarting IME often resolves it.
1. Restart IBus
ibus restart2. Manually Enable Mozc
ibus engine mozc3. Restart PC
Temporary issues may be resolved by rebooting.
6. FAQ (Frequently Asked Questions)
This section answers common questions regarding Japanese input not working or behaving inconsistently on Ubuntu. If previous steps did not solve your issue, refer to this FAQ.
Q1. What should I do if Japanese input suddenly stops working?
A:
First, try restarting IBus:
ibus restartIf it still doesn’t work, reapply the Mozc engine:
ibus engine mozcReinstalling Mozc can also help:
sudo apt install --reinstall ibus-mozcQ2. How can I change the Japanese input switching key?
A:
You can change IME switching keys as follows:
- Open “Settings” → “Keyboard Shortcuts”
- Find “Switch input method” or “Select next input source”
- Assign your preferred key combination (e.g., Super + Space, Ctrl + Shift)
Q3. Japanese input does not work in Chrome only. Why?
A:
This is usually caused by hardware acceleration.
Solution:
- Enter
chrome://settings/ - Go to “Advanced Settings” → “System”
- Disable “Use hardware acceleration when available”
- Restart Chrome
Q4. Can I use Japanese input in Ubuntu on WSL (Windows Subsystem for Linux)?
A:
WSL does not support IME directly. However, GUI apps may accept Japanese input when combined with Windows’ IME and an X server (VcXsrv, X410, etc.).
That said, setup is complex, so WSL is generally best used with English input for CLI tasks.
Q5. Conversion candidates or predictive suggestions do not appear in Japanese input.
A:
Mozc prediction features may be disabled.
Fix:
- Open Mozc settings:
ibus-setup- Enable “Suggestions” and “Auto-Learning” features
- Save and restart IBus
7. Summary and Additional Resources
This article provided a detailed guide for resolving issues where Japanese input does not work on Ubuntu. Below is a summary of key points and helpful resources for further reference.
7.1 Summary of Key Points
To ensure Japanese input works correctly on Ubuntu, follow these steps:
- Identify the cause
- Check if IME (Mozc, Fcitx) is installed
- Verify IME configuration
- Confirm keyboard layout settings
- Check for application-specific issues (Chrome, VS Code)
- Configure Mozc properly
- Install
ibus-mozcand add it to Input Sources - Reload input method using
ibus restart - Switch Japanese input with Hankaku/Zenkaku or Ctrl + Space
- Consider using alternative IMEs like Fcitx or Anthy
- Fcitx: lightweight and fast
- Anthy: useful in environments where Mozc cannot run
- Perform troubleshooting when issues persist
- Restart IME with
ibus restartor set engine viaibus engine mozc - Disable Chrome hardware acceleration if input fails
- Reset IBus settings using
dconf reset -f /desktop/ibus/
- Check FAQ for additional solutions
- Sudden IME failures
- IME usage in WSL or Live USB environments
- Prediction settings not working
By following these steps, you can reliably restore Japanese input functionality on Ubuntu.
7.2 Additional Resources
If you need more information or want to check the latest Ubuntu documentation, refer to the following resources:
- Ubuntu Official Documentation
https://help.ubuntu.com/ - Ubuntu Japanese Forum (Discussion and Q&A)
https://forums.ubuntulinux.jp/ - Mozc Official Repository
https://github.com/google/mozc - Fcitx Official Documentation
https://fcitx-im.org/wiki/Fcitx - Linux Community Technical Blogs
- Qiita (Ubuntu tag): https://qiita.com/tags/ubuntu
- Ask Ubuntu (English Q&A): https://askubuntu.com/
7.3 Conclusion
For beginners, configuring Japanese input on Ubuntu can feel complicated. However, by following the procedures outlined in this guide step by step, most issues can be resolved.
If you still cannot solve the problem, consider seeking help on Ubuntu forums or Linux-related communities.
With proper configuration, you can enjoy a smooth Japanese typing experience on Ubuntu. Set up your environment and work comfortably!



