Software⏱️ 3 min read📅 2026-06-11

How to Fix: X2Go error: home directory path contains non-ASCII characters

X2Go error fix for non-ASCII home directory path.

Quick Answer: Check the remote Ubuntu workstation's user database and ensure all user names and paths are encoded correctly, or use X2Go's built-in encoding feature to handle non-ASCII characters.

📋 Table of Contents

  1. 💡 Why You Are Getting This Error
  2. 🛠️ Step-by-Step Verified Fixes
  3. ✨ Wrapping Up

The X2Go error 'home directory path contains non-ASCII characters' is affecting all local users of X2Go when attempting to access a remote Ubuntu workstation. This issue prevents users from connecting to their home directories, resulting in a failed session startup. The good news is that the problem doesn't seem to affect SSH connections, which suggests that the issue is specific to X2Go and not related to the underlying file system.

This error can be frustrating for users who rely on X2Go for remote access to their workstations. However, with the right troubleshooting steps, it's possible to resolve this issue and get your users back up and running.

💡 Why You Are Getting This Error

  • The primary cause of this error is that the home directory path contains non-ASCII characters, which are not compatible with the X2Go protocol. This can happen when a user's home directory is created on a system with a different character set than the one used by the remote workstation.
  • An alternative reason for this error could be that the X2Go server or client configuration is not properly configured to handle non-ASCII characters in home directory paths.

🛠️ Step-by-Step Verified Fixes

Fixing Non-ASCII Characters in Home Directory Paths

  1. Step 1: Step 1: Identify and Fix Non-ASCII Characters in Home Directory Path
  2. Step 2: Check the home directory path of each affected user to identify any non-ASCII characters. You can use the `ls -l` command with the `-c` option to view the file system encoding for the home directory.
  3. Step 3: Once you've identified the problematic character, you'll need to fix it by either decoding the character or replacing it with an equivalent ASCII character. Be sure to test your changes before applying them to all users.

Configuring X2Go to Handle Non-ASCII Characters

  1. Step 1: Step 1: Configure X2Go to Use a Different Character Set
  2. Step 2: Edit the X2Go server configuration file (usually `x2go.conf` or `x2go-server.conf`) and set the `charSet` option to a character set that supports non-ASCII characters, such as UTF-8.
  3. Step 3: Restart the X2Go server service after making changes to the configuration file.

✨ Wrapping Up

To resolve the 'home directory path contains non-ASCII characters' error in X2Go, you can either fix non-ASCII characters in home directory paths or configure X2Go to handle non-ASCII characters. By following these steps, you should be able to get your users back up and running with their remote workstations.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions

🛠️ Related Fixes

How to Fix: Pc crashes shortly after launching game (rainbow

Fix Pc crashes shortly after launching game (rainbow six siege). Compl

How to Fix: Installing an APK on a locked down phone

Installing an APK on a locked down phone: Try using a rooted device, e

How to Fix: New PC build- no signal and no clue

Fix New PC build- no signal and no clue. Complete troubleshooting guid