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

How to Fix: How to get rid of error message on ssh login --> "setterm: terminal xterm does not support --blength"

Error message on SSH login in Arch Linux box due to terminal attribute not supported.

Quick Answer: Check the /etc/terminfo file for any settings that might be causing the issue, and consider adding a custom terminfo setting to override the default.

📋 Table of Contents

  1. 💡 Why You Are Getting This Error
  2. 🚀 How to Resolve This Issue
  3. 💡 Conclusion

The error message 'setterm: terminal xterm does not support --blength' occurs when SSHing into an Arch Linux box, causing a minor but frustrating issue. This error affects users who connect to their Arch Linux system via SSH and see this message displayed on the login screen.

This issue can be annoying because it interrupts the user's experience with a system that is already running. Fortunately, this problem has a solution that can be applied through a few simple steps.

💡 Why You Are Getting This Error

  • The primary reason for this error lies in the configuration of the terminal settings on the Arch Linux system. The 'xterm' terminal emulator does not support the '--blength' option, which is used by some SSH clients to display the length of the shell prompt. This mismatch can cause the error message to appear when SSHing into the system.
  • Another possible reason for this issue could be related to the configuration of PuTTY or other SSH clients, but since you've ruled that out in your troubleshooting steps, we'll focus on resolving the problem within the Arch Linux terminal settings.

🚀 How to Resolve This Issue

Configuring Terminal Settings

  1. Step 1: Step 1: Check and modify the terminal settings in /etc/profile. Open this file in a text editor using 'sudo nano /etc/profile'. Locate the line that starts with 'TERM' and set it to 'xterm-256color'. This will ensure that the correct terminal emulator is used, which supports '--blength'.
  2. Step 2: Step 2: Verify the changes by restarting your SSH session or logging out and back in. You should no longer see the error message when SSHing into your Arch Linux system.
  3. Step 3: Step 3: To prevent this issue from occurring in the future, consider adding a script to /etc/profile that sets the terminal settings before each new shell is started. This can be achieved by creating a custom bashrc file or modifying the existing one to include the necessary configuration.

Alternative Fix Method

  1. Step 1: Step 1: Create a custom bashrc file to override the default terminal settings. Open 'sudo nano ~/.bashrc' and add the following line at the end: export TERM=xterm-256color. This will set the correct terminal emulator for your SSH sessions.
  2. Step 2: Step 2: Save and close the file, then restart your SSH session or log out and back in to test the changes.

💡 Conclusion

By following these steps, you should be able to resolve the 'setterm: terminal xterm does not support --blength' error message when SSHing into your Arch Linux system. Remember to check and modify your terminal settings regularly to prevent this issue from occurring in the future.

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