← Back to Docs

Beginner's Guide

First time using Linux? Start here — terminal basics, where to look things up, the Chinese environment, and choosing a desktop.

What is Linxira

Linxira is a desktop supercomputer built on Arch Linux: it ships with the KDE Plasma desktop and is ready to use right after installation. You don't need to understand distribution concepts — think of it as a Linux computer with research software preconfigured.

Terminal Basics

Opening a terminal: KDE application menu → Terminal (Konsole), or press Ctrl+Alt+T.

The most useful commands:

CommandWhat it does
pwdShow the current directory
lsList files in the current directory
cd 目录名Change into a directory
sudo 命令Run a command as administrator (asks for your password the first time; nothing is shown while typing)
sudo pacman -SyuUpdate the whole system
sudo pacman -Ss 关键词Search for software
sudo pacman -S 包名Install software
sudo pacman -Rns 包名Remove software
man 命令Read the manual for a command (press q to quit)

Got an error? Terminal output is in English — copy the error message into a search box. Almost every problem has been seen before and has an answer online.

Where to Look Things Up: the Arch Wiki

The Arch Wiki is the official Arch documentation, maintained by Linux users worldwide. Since Linxira is based on Arch, its answers apply directly. Open https://wiki.archlinux.org/ and use the search box on the page.

Want it in Chinese? Pick 「中文(简体)」 from the language menu in the top-left corner; the entry URL then gets a (简体中文) suffix. For example, the Chinese Pacman entry: https://wiki.archlinux.org/title/Pacman_(简体中文).

Quick reference of common entries:

TopicEntry to search for
Installing softwarePacman
DesktopKDE
Input methodsFcitx5
Chinese environmentLocalization / 简体中文
GraphicsNVIDIA / AMDGPU
AudioPipeWire
NetworkingNetwork configuration
Boot & recoveryGRUB / Btrfs
System backupTimeshift

Other official entry points: the site navigation on the home page — Download / Docs / Ecosystem / Roadmap / Blog — and the GitHub organization at https://github.com/Linxira-OS.

Chinese Environment

Chose Chinese during installation → language, locale (zh_CN.UTF-8) and the Fcitx5 input method are already configured. Nothing to do.

Installed in English and want Chinese: KDE System Settings → Regional Settings / Language → Add 「简体中文」→ drag it to the top of the list → log out and back in. If some apps stay in English, install their language packs:

sudo pacman -S firefox-i18n-zh-cn libreoffice-still-zh-cn

Chinese input method not working? Troubleshoot in three steps:

1) Make sure it is installed — run sudo pacman -S fcitx5 fcitx5-chinese-addons fcitx5-configtool.

2) Enable Pinyin — System Settings → Input Method → Add Input Method → choose「拼音(Pinyin)」. The input method switch shortcut is Ctrl+Space.

3) Still broken? Check the diagnostic report — run fcitx5-diagnose | head -n 100 and paste the output to a community or search engine. Linxira uses Fcitx5 system-wide — do not install other frameworks such as ibus alongside it, to avoid conflicts.

If you installed a non-KDE desktop yourself (e.g. GNOME) and the input method does not take effect, write these three lines to ~/.xprofile and restart your session:

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

If the locale is not taking effect (the locale command output looks wrong): run sudo nano /etc/locale.gen, uncomment the zh_CN.UTF-8 UTF-8 line, then run sudo locale-gen.

Choosing a Desktop Environment

The default desktop is KDE Plasma. During installation you choose between KDE Plasma and Server (no desktop). You can install any other desktop (Plasma, GNOME, and more) yourself at any time. "Headless mode" only turns the desktop off temporarily to free memory for compute — it is not a desktop switch. See Desktop & Server Mode.