Quick Start

First time using Linux? Start with the Beginner's Guide — terminal basics, looking things up, and the Chinese environment.

First steps after installation: enable the signed repository, install software, and start working.

1. Enable the official signed repository [linxira]

First-party software is hosted on the signed repository [linxira]. It is configured automatically on install; to add it manually, append to /etc/pacman.conf:

[linxira]
Server = https://linxira-os.github.io/linxira-packages/x86_64
SigLevel = Required DatabaseOptional

Import and trust the signing key

Installing the linxira-keyring package imports and locally signs the release key automatically:

sudo pacman-key --init
sudo pacman -Sy linxira-keyring

Installing linxira-keyring makes pacman import and trust the release key automatically; fingerprints are not published on this site.

2. Update the system

sudo pacman -Syu

3. Install software

Choose from the Software Ecosystem (92 curated applications) or install directly with pacman:

sudo pacman -S firefox libreoffice-fresh vlc

4. Configure mirrors (optional)

Use linxira-config to manage mirrors for each language ecosystem, with auto speed-testing:

linxira-config mirror pip auto   # auto-pick fastest PyPI mirror
linxira-config mirror arch list  # list Arch mirrors
linxira-config mirror npm auto   # auto-pick fastest npm mirror (run this if npmjs.org is slow)

5. Enable remote access (optional)

Turn the machine into a server:

linxira-config ssh on
linxira-config ssh key add

See Remote Access (SSH).

6. One-click AI CLI tools (optional)

Switch the npm mirror first for faster installs:

linxira-config mirror npm auto

Then install the coding agents you need (all official npm packages):

npm i -g @anthropic-ai/claude-code@latest   # Claude Code
npm i -g @openai/codex@latest                # Codex
npm i -g @google/gemini-cli@latest           # Gemini CLI
npm i -g @xai-official/grok@latest           # Grok Build
npm i -g opencode-ai@latest                  # OpenCode
npm i -g openclaw@latest                     # OpenClaw

Other terminal agents: Hermes via curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash (CN mirror res1.hermesagent.org.cn); Pi / OMP via curl -fsSL https://omp.sh/install | sh.