Last Updated: 3/12/2026

Environment Variables

Set environment variables for your Hyprland Wayland session to configure cursor themes, toolkit backends, and application behavior.

Setting Environment Variables

env = VARIABLE_NAME, value

Variables are set before applications launch and persist for the entire session.

Common Environment Variables

Cursor Configuration

env = XCURSOR_SIZE, 24
env = HYPRCURSOR_SIZE, 24

Controls cursor size for X11 and Wayland applications.

Toolkit Backends

env = GDK_BACKEND, wayland,x11
env = QT_QPA_PLATFORM, wayland;xcb
env = SDL_VIDEODRIVER, wayland
env = CLUTTER_BACKEND, wayland

Forces toolkits to use Wayland when available, with X11 fallback.

Qt Specific

env = QT_AUTO_SCREEN_SCALE_FACTOR, 1
env = QT_WAYLAND_DISABLE_WINDOWDECORATION, 1

Firefox

env = MOZ_ENABLE_WAYLAND, 1

Enables native Wayland support in Firefox.

Example Configuration

From the example config:

env = XCURSOR_SIZE, 24
env = HYPRCURSOR_SIZE, 24

What’s Next

Learn about automatic application launching with Autostart.