phosh-session(1)

phosh-session1

Session startup script for phosh

Usage

phosh-session [OPTIONS...]

Overview

phosh-session is the script to startup phosh including required components like the Wayland compositor phoc and an on screen keyboard like stevia or squeekboard. The script is rarely invoked by a user but rather activated by a display manager or systemd unit. However it's perfectly valid to e.g. log into a tty and run phosh-session to bring up phosh and needed components.

Options

-h, --help

Print help and exit

--version

Print version and exit

Configuration files

The session script looks at the following configuration files:

•

/usr/share/phosh/phoc.ini: Configuration passed to the compositor

•

/etc/phosh/phoc.ini: Used instead of the above if present

Environment

phosh-session honors the following environment variables:

•

WLR_BACKENDS: The backends the wlroots library should use when phoc launches. See <https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md>

For debugging purposes you can put environment variables into ~/.phoshdebug which is read at session startup.

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

--version since Debian 13 (Trixie).

From phosh 0.57.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.