18bb3e6138
Multi-upstream mode is confusing for new users. Let's explain how it works in a separate file.
1.5 KiB
Getting started
Server side
To create an admin user and start soju, run these commands:
sojuctl create-user <soju username> -admin
soju -listen irc+insecure://127.0.0.1:6667
If you're migrating from ZNC, a tool is available to import users, networks and channels from a ZNC config file:
go run ./contrib/znc-import.go <znc config file>
Client side
Client supporting soju.im/bouncer-networks
If your are using a client supporting the soju.im/bouncer-networks IRC
extension (see the client list), then you can just connect to soju with your
username and password.
If your client doesn't provide a UI to manage IRC networks, you can talk to
BouncerServ. See the man page or use /msg BouncerServ help.
Other clients
You will need to setup one separate server in your client for each server you want soju to connect to.
The easiest way to get started is to specify the IRC server address directly in
the username in the client configuration. For example to connect to Libera Chat,
your username will be: <soju username>/irc.libera.chat. Also set your soju
password in the password field of your client configuration.
This will autoconfigure soju by adding a network with the address
irc.libera.chat and then autoconnect to it. You will now be able to join
any channel like you would normally do.
For more advanced configuration options, you can talk to BouncerServ. See the
man page or use /msg BouncerServ help.