> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryoku.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# First boot

> What you see when you log in to Ryoku for the first time, and the four keys worth pressing first.

After install, the machine reboots into SDDM. Pick the **Ryoku (Hyprland)**
session and log in.

## What you see

* **The frame.** A rounded screen border, the desktop's signature chrome.
  Popouts melt into it instead of floating on top.
* **The pill.** A morphing bar at the top of the screen, and its popouts. It
  is the centerpiece of the desktop; everything you summon (notifications, the
  GNOME keyring prompt, the update island) grows from it.
* **The wallpaper, with the clock and weather desktop widgets painted on it.**
* **No windows yet.** Hyprland is a tiling compositor, so nothing is open
  until you open it.

`Mod` is `Super` (the Windows or Cmd key on most keyboards).

## Four keys worth pressing first

<CardGroup cols={2}>
  <Card title="Open a terminal" icon="terminal">
    `Mod + Return` launches `kitty`, the shipped terminal.
  </Card>

  <Card title="Open the launcher" icon="search">
    `Mod + Space` opens the app launcher. Type to filter, Enter to launch.
  </Card>

  <Card title="Open Ryoku Settings" icon="sliders" href="/docs/settings">
    `Mod + ,` opens the Hub, the live control center for the whole desktop.
    See [Settings](/docs/settings).
  </Card>

  <Card title="See the keybind legend" icon="keyboard">
    `Mod + K` opens the Hub on its live shortcut legend. It is the same data
    as the [Keybindings](/docs/keybindings) page, read from the running
    Hyprland config.
  </Card>
</CardGroup>

## Next steps

* [Navigation](/docs/navigation): the keyboard workflow — open, focus, move,
  and tile windows across workspaces.
* [Desktop tour](/docs/tour): the shell surfaces and where things live.
* [Keybindings](/docs/keybindings): the full shipped reference, grouped by
  purpose.
* [Customize](/docs/customize): wallpapers, themes, and your own
  `~/.config/hypr/user.lua`.

## If nothing draws

If the pill, the launcher, or Ryoku Settings fail to appear, switch to a TTY
(`Ctrl + Alt + F2`), log in, then restart the shell and read its log:

```bash theme={"dark"}
ryoku reload
tail -n 80 ~/.local/state/ryoku-shell.log
hyprctl binds
```

[Troubleshoot](/docs/troubleshoot) covers the common boot and login issues.