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

# Quick Start

> Connect to your first IRC server in under a minute

## First Launch

```bash theme={null}
flume
```

You'll see Flume's interface with a message suggesting you add a network.

## Add a Network

The simplest way — everything in one command:

```
/server add libera irc.libera.chat 6697 -tls -autoconnect
```

### With Credentials

Store your password in the encrypted vault, then reference it with `${name}`:

```
/secure init
/secure set libera_pass your-password
/server add libera irc.libera.chat 6697 -tls -autoconnect -username mynick -password ${libera_pass}
```

### SASL Authentication

For networks that require SASL (like Libera Chat):

```
/server set libera auth_method sasl
/server set libera sasl_username mynick
/server set libera sasl_password ${libera_pass}
```

### NickServ Authentication

```
/server set libera auth_method nickserv
/server set libera nickserv_password ${libera_pass}
```

The `${libera_pass}` syntax references the vault secret — your password is never stored in plain text.

## Save and Connect

```
/save
/connect libera
```

## Join Channels

```
/join #flume
/join #rust
```

## Navigate

| Key              | Action                   |
| ---------------- | ------------------------ |
| `Alt+1-9`        | Jump to buffer by number |
| `Alt+Left/Right` | Cycle buffers            |
| `Ctrl+X`         | Cycle servers            |
| `PageUp/Down`    | Scroll                   |
| `Tab`            | Nick completion          |

Or use `/go`:

```
/go #rust
/go 3
```

## Emoji

Type `:shortcode:` in messages — replaced with emoji on send:

```
:thumbsup: → 👍    :wave: → 👋    :fire: → 🔥
```

Tab-complete: type `:thu` then Tab. Search: `/emoji fire`.

## Next Steps

* [Configure your setup](/configuration/overview)
* [Learn the commands](/commands/chat)
* [Write a script](/scripting/overview)
* [Generate with AI](/commands/generate)