Arch Linux Wiki

https://wiki.archlinux.org/title/
Admin
Arch Linux Wiki is a comprehensive documentation resource for Arch Linux, covering installation,...
Tokens:7,985,149
Snippets:67,136
Trust Score:9.9
Update:1 week ago
Show doc for...
Tokens:
Raw
### Example ~/.xprofile configuration

Source: https://wiki.archlinux.org/title/.xprofile

Create ~/.xprofile if it does not exist and add commands for programs to start with the session. This example starts tint2 and nm-applet in the background.

```shell
tint2 &
nm-applet &
```

--------------------------------

### Manual setup: start cherrymusic for initial setup

Source: https://wiki.archlinux.org/title/CherryMusic

Starts CherryMusic for the first time. It creates data and configuration files in ~/.local/share/cherrymusic/ and ~/.config/cherrymusic/, prints a note to stdout, and exits.

```bash
$ cherrymusic

```

--------------------------------

### Quick start: run cherrymusic with setup on port 8080

Source: https://wiki.archlinux.org/title/CherryMusic

Starts CherryMusic with an interactive setup on port 8080. After running, open localhost:8080 in a browser to configure options and create the admin account.

```bash
$ cherrymusic --setup --port 8080

```

```bash
$ _browser_ localhost:8080

```

--------------------------------

### Example DefaultDesktopCommand for Xfce

Source: https://wiki.archlinux.org/title/NoMachine

Example configuration line for /usr/NX/etc/node.cfg to start Xfce with the required DBUS environment.

```text
DefaultDesktopCommand "env DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(id -u)/bus /usr/bin/startxfce4"

```

--------------------------------

### Setup Yandex.Disk

Source: https://wiki.archlinux.org/title/Yandex_Disk

Run the setup wizard to configure proxy, user, and local folder. Syncing starts after this step.

```bash
$ yandex-disk setup

```

--------------------------------

### UEFI capsule update via fwupdtool

Source: https://wiki.archlinux.org/title/Lenovo_Yoga_Pro_7_14ASP9

Commands to extract the firmware installer, get the system firmware GUID, and install the UEFI capsule update. Requires AC power and the latest Windows firmware installer from Lenovo.

```bash
# extract files from the installer (called pscnxxxx.exe)
7z x pscnxxxx.exe
# the important file is WinPSCNXXXX.fd (where XXXX is the version number)

# get the GUID of the firmware device
sudo fwupdtool get-devices | grep -A 1 "System Firmware"

# prepare the UEFI capsule update
sudo fwupdtool install-blob WinPSCNXXXX.fd [GUID]
```

--------------------------------

### Restart nxserver

Source: https://wiki.archlinux.org/title/FreeNX

Restarts the nxserver after configuration changes. The server is set to start automatically at installation, but a restart is likely needed after setup.

```bash
/usr/NX/bin/nxserver --restart
```

--------------------------------

### Run hp-setup with GUI frontend

Source: https://wiki.archlinux.org/title/CUPS/Printer-specific_problems

Launches the hplip setup tool with the Qt GUI frontend. Requires python-pyqt5, CUPS installed, cups.service started, and lsusb (usbutils).

```bash
$ hp-setup -u

```

--------------------------------

### Example ~/.xinitrc for switching desktop environments

Source: https://wiki.archlinux.org/title/.xinitrc

The following example shows how to start a particular desktop environment or window manager with an argument. The full content is not shown here.

```bash
~/.xinitrc

```

--------------------------------

### Autostart example with panel, conky, and wallpaper

Source: https://wiki.archlinux.org/title/PekWM

Example autostart entries for xfce4-panel, conky, and hsetroot. The file must be made executable before use.

```shell
xfce4-panel &
conky &
hsetroot -fill ~/images/darkwood.jpg &

```

--------------------------------

### Install Red Hat OpenShift Local (CRC) basic steps

Source: https://wiki.archlinux.org/title/OpenShift

Commands to install and start a Red Hat OpenShift Local (CRC) cluster. Requires libvirt, qemu-base, networkmanager, and dnsmasq or systemd-resolved. The crc setup command will ask for a secret from cloud.redhat.com.

```bash
#untar downloaded archive
tar -xJf crc-linux-amd64.tar.xz
#create a bin link so that future versions only need relinking, no new path
ln -s crc-linux-<VERSION>-amd64 bin
#add bin folder to PATH and restart your terminal so that PATH is updated (or source config file)
...
#create base install of crc takes some minutes (will ask for secret)
crc setup
#start openshift cluster
crc start
#get credentials of openshift instance
crc console --credentials
#open console in webbrowser
crc console
```

--------------------------------

### Full example of setting up xdg-dbus-proxy and bwrap with .flatpak-info

Source: https://wiki.archlinux.org/title/Bubblewrap

Full example showing how to set up a dbus proxy and run bwrap with a .flatpak-info file to trick xdg-desktop-portal. The example includes a function to set up the proxy and a bwrap command with a placeholder for additional arguments.

```bash
APP_NAME=app.application.Name
APP_FOLDER="$XDG_RUNTIME_DIR/app/$APP_NAME"
mkdir -p "$APP_FOLDER"
set_up_dbus_proxy() {
 bwrap \
   --new-session \
   --symlink /usr/lib64 /lib64 \
   --ro-bind /usr/lib /usr/lib \
   --ro-bind /usr/lib64 /usr/lib64 \
   --ro-bind /usr/bin /usr/bin \
   --bind "$XDG_RUNTIME_DIR" "$XDG_RUNTIME_DIR" \
   --ro-bind-data 3 "/.flatpak-info" \
   --die-with-parent \
   -- \
   env -i xdg-dbus-proxy \
   "$DBUS_SESSION_BUS_ADDRESS" \
   "$APP_FOLDER/bus" \
   --filter \
   --log \
   --talk=org.freedesktop.portal.Flatpak \
   --call="org.freedesktop.portal.Desktop=org.freedesktop.portal.Settings.Read@/org/freedesktop/portal/desktop" \
   --broadcast="org.freedesktop.portal.Desktop=org.freedesktop.portal.Settings.SettingChanged@/org/freedesktop/portal/desktop" 3<<EOF
[Application]
name=$APP_NAME
EOF
}

set_up_dbus_proxy &
sleep 0.1

bwrap \
  ...
  --ro-bind-data 3 /.flatpak-info \
  ...
  3<<EOF
[Application]
name=$APP_NAME
EOF

```

--------------------------------

### Watch folder setup for moving completed torrents

Source: https://wiki.archlinux.org/title/RTorrent

Example ~/.rtorrent.rc configuration that watches a directory for new .torrent files, starts them, and moves completed data to a specified folder. Uses schedule, method.insert, and method.set_key to define the workflow.

```rtorrent.rc
# default path for in progress downloads
directory = /home/user/torrents/incomplete

# schedule a timer event named 'watch_directory_1':
# 1) triggers 10 seconds after rtorrent starts
# 2) triggers at 10 second intervals thereafter
# 3) Upon trigger, attempt to load (and start) new *.torrent files found in /home/user/torrents/watch/
# 4) set a variable named 'custom1' with the value "/home/user/torrents/complete"
# NOTE: if you do not want it to automatically start the torrent, change 'load.start' to 'load.normal'
schedule = watch_directory_1,10,10,"load.start=/home/user/torrents/watch/*.torrent,d.custom1.set=/home/user/torrents/complete"

# upon completion, move content to path specified above via custom1
method.insert = d.data_path, simple, "if=(d.is_multi_file), (cat,(d.directory),/), (cat,(d.directory),/,(d.name))"
method.insert = d.move_to_complete, simple, "d.directory.set=$argument.1=; execute=mkdir,-p,$argument.1=; execute=mv,-u,$argument.0=,$argument.1=; d.save_full_session="
method.set_key = event.download.finished,move_complete,"d.move_to_complete=$d.data_path=,$d.custom1="

```

--------------------------------

### Set up key-handler directory and copy example

Source: https://wiki.archlinux.org/title/Sxiv

Creates the ~/.config/sxiv/exec/ directory and copies the example key-handler script from /usr/share/sxiv/exec/key-handler. The script must be marked executable.

```shell
$ mkdir -p ~/.config/sxiv/exec/
$ cp /usr/share/sxiv/exec/key-handler ~/.config/sxiv/exec/key-handler

```

--------------------------------

### Attach a running program to screen with reptyr

Source: https://wiki.archlinux.org/title/GNU_Screen

Use reptyr to reparent a process started outside Screen into a screen window. Install the reptyr package, get the PID with ps ax, and run the command inside a screen window.

```bash
$ reptyr _pid_

```

--------------------------------

### Create autostart entry ~/.config/autostart/super-key-monitor.desktop

Source: https://wiki.archlinux.org/title/Compose_key

Create this desktop entry to start the monitor with the session via XDG autostart. Ensure Hidden=false or absent, otherwise the entry is silently skipped and the monitor won't start.

```bash
~/.config/autostart/super-key-monitor.desktop
```

--------------------------------

### Install Passenger module for Nginx

Source: https://wiki.archlinux.org/title/Redmine

Runs the passenger installer for Nginx. The installer provides further instructions for setup.

```bash
# passenger-install-nginx-module

```

--------------------------------

### Install and start Pry

Source: https://wiki.archlinux.org/title/Chruby

Install Pry and launch the interactive shell.

```bash
$ gem install pry
$ pry
```

--------------------------------

### Autostart file example: ~/.config/lxsession/LXDE/autostart

Source: https://wiki.archlinux.org/title/LXDE

Each line in the autostart file is a command to execute. Lines starting with @ are automatically re-executed if the command crashes. Commands do not end with &.

```plaintext
~/.config/lxsession/LXDE/autostart

```

```plaintext
@lxterminal
@leafpad

```

--------------------------------

### Manual installation with example path

Source: https://wiki.archlinux.org/title/Install_Arch_Linux_on_WSL

Example command using a specific image path. The default distro name is `archlinux`; use `--name` to change it.

```powershell
> wsl --install --from-file C:\Users\_Username_\Downloads\archlinux-2025.04.01.121271.wsl

```

--------------------------------

### Install newsraft from AUR

Source: https://wiki.archlinux.org/title/Newsraft

Install the newsraftAUR package to get Newsraft.

```bash
Install the newsraftAUR package.
```

--------------------------------

### Run archinstall guided installer

Source: https://wiki.archlinux.org/title/Archinstall

Runs the guided installer from the live medium. The installer will perform or ask for user input on multiple steps, and leaving the root password blank disables the root account, using sudo for privilege elevation.

```bash
# archinstall

```

--------------------------------

### Boot prompt configuration example

Source: https://wiki.archlinux.org/title/PXELINUX

A simple syslinux.cfg that shows a boot prompt and auto-boots after 5 seconds. Set PROMPT to 0 to boot directly. Adjust kernel parameters and paths as needed.

```syslinux
PROMPT 1
TIMEOUT 50
DEFAULT arch

LABEL arch
	LINUX ../vmlinuz-linux
	APPEND root=UUID=_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_ rw
	INITRD ../initramfs-linux.img

LABEL archfallback
	LINUX ../vmlinuz-linux
	APPEND root=UUID=_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_ rw
	INITRD ../initramfs-linux-fallback.img

```

--------------------------------

### Run VMware Tools installer

Source: https://wiki.archlinux.org/title/VMware/Install_Arch_Linux_as_a_guest

Starts the VMware Tools installation script.

```bash
# perl /root/vmware-tools-distrib/vmware-install.pl
```

--------------------------------

### Example configuration file

Source: https://wiki.archlinux.org/title/Yt-dlp

Shows the syntax for yt-dlp configuration files: one command-line option per line. Comments start with #. This example sets --ignore-errors, disables playlist, saves to ~/Videos, and prefers 1080p or lower.

```bash
--ignore-errors
# --no-playlist

# Save in ~/Videos
-o ~/Videos/%(title)s.%(ext)s

# Prefer 1080p or lower resolutions
-f bestvideo[height<=?1080]+bestaudio/best

```

--------------------------------

### Boot from ISO and raw disk image with qemu-system-x86_64

Source: https://wiki.archlinux.org/title/QEMU

Starts QEMU to install an OS from a bootable ISO attached as CD-ROM and a raw disk image. Boot order is set to 'd' (CD-ROM). Default memory is 128 MiB; adjust with -m.

```bash
$ qemu-system-x86_64 -cdrom _iso_image_ -boot order=d -drive file=_disk_image_,format=raw
```

--------------------------------

### Start EXWM from xinitrc

Source: https://wiki.archlinux.org/title/EXWM

Add this line to your xinitrc to start EXWM when X starts. Requires emacs and xorg-xinit installed.

```shell
exec emacs

```

--------------------------------

### Run fscrypt setup

Source: https://wiki.archlinux.org/title/Fscrypt

Initializes fscrypt, creating /etc/fscrypt.conf and /.fscrypt. Run as root.

```bash
# fscrypt setup

```

--------------------------------

### xorg.conf.d tree example

Source: https://wiki.archlinux.org/title/Xorg_multiseat

Shows the file tree of Xorg configuration files for a two-seat setup, with files for keyboard, monitors, server flags, graphics, screens, and layouts.

```text
├── 00-keyboard.conf   #created by localectl
├── 31-monitor-seat0.conf
├── 32-monitor-seat1.conf
├── 40-serverflags.conf
├── 41-graphic-seat0.conf
├── 42-graphic-seat1.conf
├── 51-screen-seat0.conf
├── 52-screen-seat1.conf
├── 61-layout-seat0.conf
└── 62-layout-seat1.conf

```

--------------------------------

### Install Passenger module for Apache

Source: https://wiki.archlinux.org/title/Redmine

Runs the passenger installer for Apache HTTP Server. The installer provides further instructions for setup.

```bash
# passenger-install-apache2-module

```

--------------------------------

### Start nushell

Source: https://wiki.archlinux.org/title/Nushell

Starts the nushell interactive shell after installation. Typically run in a terminal.

```bash
$ nu

```

--------------------------------

### Launch QEMU to test backup

Source: https://wiki.archlinux.org/title/Full_system_backup_with_SquashFS

Boots the backup device in QEMU using the host kernel and initramfs. Replace /dev/sdB with the backup device and _virtual_machine_ram_in_MiB_ with the desired RAM in MiB. Requires KVM support.

```bash
$ qemu-system-x86_64 \
  -kernel /boot/vmlinuz-linux \
  -append "root=/dev/sdB ro loglevel=3 init=/usr/lib/systemd/systemd" \
  -initrd /boot/initramfs-linux-fallback.img \
  -drive file=/dev/sdB,index=0,media=disk,format=raw \
  -m _virtual_machine_ram_in_MiB_ \
  --enable-kvm \
  -cpu host

```

--------------------------------

### Install Enlightenment

Source: https://wiki.archlinux.org/title/Moksha

Install the enlightenment package to get the Enlightenment window manager and EFL.

```bash
pacman -S enlightenment
```

--------------------------------

### Extract Xilinx ISE installation tarball

Source: https://wiki.archlinux.org/title/Xilinx_ISE_WebPACK

Extracts the Xilinx ISE 14.7 installation tarball. Run this before starting the manual installation.

```bash
$ tar -xvf Xilinx_ISE_DS_Lin_14.7_1015_1.tar

```

--------------------------------

### Example attach script with actual device paths

Source: https://wiki.archlinux.org/title/IOMMU

Example of attaching a mouse and keyboard to a virtual machine named win10. Uses full paths to XML files. Ensure scripts are executable.

```sh
#!/bin/env sh

virsh attach-device win10 /home/$USER/.VFIOinput/input_mouse.xml
virsh attach-device win10 /home/$USER/.VFIOinput/input_keyboard.xml
```

--------------------------------

### Install a Ruby version

Source: https://wiki.archlinux.org/title/RVM

Installs a specified Ruby version. Replace <ruby_version> with the desired version. For example, 'rvm install 1.9.2'.

```bash
$ rvm install <ruby_version>

```

--------------------------------

### Examples of listing options and properties

Source: https://wiki.archlinux.org/title/QEMU

These commands show how to list machine types, properties for the q35 machine, device types, and properties for the qxl device.

```bash
$ qemu-system-x86_64 -machine help
$ qemu-system-x86_64 -machine q35,help
$ qemu-system-x86_64 -device help
$ qemu-system-x86_64 -device qxl,help

```

--------------------------------

### Simple GRUB Installation: Mount filesystem

Source: https://wiki.archlinux.org/title/Multiboot_USB_drive

Mounts the USB drive filesystem to /mnt before installing GRUB in the simple installation guide.

```bash
# mount /dev/sdXY /mnt

```

--------------------------------

### ~/.Xkbmap - keyboard layout example

Source: https://wiki.archlinux.org/title/LightDM

Example ~/.Xkbmap file with arguments for Xkbmap. The script runs Xkbmap with these arguments if the file exists.

```text
-model pc105 -layout us,us,tr -variant ,dvorak,f -option grp:caps_toggle

```

--------------------------------

### Launch QEMU with run-qemu script

Source: https://wiki.archlinux.org/title/QEMU/Advanced_networking

Example command to launch a virtual machine using the run-qemu script with a disk image and 512 MB RAM.

```bash
$ run-qemu -hda _myvm.img_ -m 512

```

--------------------------------

### Show nxserver help

Source: https://wiki.archlinux.org/title/FreeNX

Run after installing nx3-allAUR to get an overview of the install and uninstall procedures.

```bash
# /usr/NX/scripts/setup/nxserver --help
```

--------------------------------

### Get Bitlbee quickstart help

Source: https://wiki.archlinux.org/title/Bitlbee

In the control channel, enter 'help quickstart' and follow the instructions.

```text
help quickstart

```

--------------------------------

### Start a domain with virsh and view with virt-viewer

Source: https://wiki.archlinux.org/title/Libvirt

Starts a domain using `virsh start` and then opens it with `virt-viewer` connecting to the QEMU user session. Replace _domain_ with the actual domain name.

```bash
$ virsh start _domain_
$ virt-viewer --connect qemu:///session _domain_

```

--------------------------------

### Start Synergy client (basic)

Source: https://wiki.archlinux.org/title/Deskflow

Starts the Synergy client, connecting to the server host. Use `-f` to run in the foreground.

```bash
$ synergyc server-host-name

```

```bash
$ synergyc -f server-host-name

```
Tokens:
Raw