NOTE: For libera.chat you must ensure you have a libera account.

We are delighted to provide a private soju instance available to all pico+ users.

Generate a login token for bouncer #

• SSH into our pico TUI
• Select "Manage Tokens" submenu
• Type "n" to generate a new token
• Save token someplace safe

Supported Clients #

Next you need to pick a client to connect to the bouncer and finish setup:

• ssh app
• web - at chat.pico.sh
• terminal - senpai

SSH App #

We integrated senpai into our SSH app. If you have a pico account you can connect via:

1ssh pico.sh -t chat

Web #

We provide pico users with a self-hosted version of gamja.

Log into chat.pico.sh #

• You'll be redirected to auth.pico.sh
• Enter the token from above
• Click submit

Back to chat.pico.sh #

• Click "remember me" (this is important)
• You'll see an error "Cannot interact with channels and users on the bouncer connection. Did you mean to use a specific network?" that's okay
• Message BouncerServ (/msg BouncerServ help) to configure the bouncer

Next step is to connect to libera.chat section.

Terminal #

Senpai is a modern terminal client coupled pretty tightly to soju development so it's a great fit for us at pico -- we use it.

senpai (terminal client)

Configure senpai #

Create a config file

1mkdir -p ~/.config/senpai
2touch ~/.config/senpai/senpai.scfg

Edit senpai.scfg

address ircs://irc.pico.sh:6697
nickname <user>
password "<pico-token>"
tls true

Open senpai

1senpai

Next step is to connect to libera.chat section.

Connect to libera #

Using:

• Network irc.libera.chat
• Channel #pico.sh

Message BouncerServ #

/msg BouncerServ help

Join a network #

network create -addr irc.libera.chat -nick <user> -enabled false
sasl set-plain -network libera <user> <sasl-pass>
network update libera -enabled true

Join pico #

/j #pico.sh

That's it! Join any other channels or networks using the same method.

References #

• libera.chat
• pico bouncer
• soju man page
• soju
• gamja
• senpai