version=pmwiki-2.2.130 ordered=1 urlencoded=1 agent=Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.0.0 Mobile Safari/537.36 author=Yonle charset=UTF-8 csum= ctime=1648914367 host=182.1.47.69 name=Soju.Guide rev=1 targets= text=## Soju%0a[Soju](https://soju.im) is A user-friendly IRC bouncer. Just like [ZNC](http://wiki.ircnow.org/index.php?n=Znc.Install), It runs on a server and stays connected after you turn off your computer or phone. It saves chat messages and replays them when you reconnect, and also helps to hide your IP address. If you are running it on IRCNow, your server may also offer DDoS protection to keep you online.%0a%0a## Getting started%0aStarting by compiling from source. You need `go` or `golang` installed for compiling soju, and `scdoc` for the documentation (optional).%0a%0a### Getting source code from git repository%0aClone the repository with `git clone` command.%0a%0a```%0acd ~%0agit clone --depth=1 https://git.sr.ht/~emersion/soju%0a```%0a%0a### Getting source code from release%0aWe're gonna fetch a tarball from upstream then extract them%0a%0a```%0aftp https://git.sr.ht/~emersion/soju/refs/download/v0.4.0/soju-0.4.0.tar.gz%0atar -xvzf soju-0.4.0.tar.gz%0acd soju-0.4.0%0a```%0a%0a### Compiling Soju%0aWhen you've been fetch the source code, start compiling by typing `make`. Before begin compiling, make sure that `go` or `golang` is installed in your VPS.%0a%0a```%0amake%0a```%0a%0aWhen building is done, Run `doas make install` to install soju into your system.%0a%0a## Configuration%0aSoju has a small server configuration which is easy to configure.%0a%0aSee [soju.1 - Config File](https://soju.im/doc/soju.1.html#CONFIG_FILE) for more information about configuration file.%0a%0aAfter configuring soju config file, Start by creating a bouncer user. You may specify `-admin` at the end for making the user as admin %0a%0a```%0a$ sojuctl create-user yourname -admin%0aPassword:%0a```%0a%0aIn case if you want to change password, do `sojuctl change-password yourname`.%0a%0a## Setting up & Connecting into network%0aStart the server by executing `soju -config soju.conf`. Modify `soju.conf` into your config filename to use your config. %0a%0aConnect into your bouncer with these credential:%0a%0aSASL Username: yourname%0aSASL Password: [your bouncer user password]%0aSASL Mechanism: PLAIN%0a%0aThen, Add a network into your bouncer by messaging to `BouncerServ`%0a%0a```%0a/msg BouncerServ network create -addr irc.ircnow.org:6697 -name IRCNow%0a```%0a%0aAfter executing this command, You will be connected into your network. %0a%0aOptionally, You may also set SASL plain / external (certfp) authentication. %0a %0aFor SASL Plain, You may do%0a```%0a/msg BouncerServ sasl set-plain -network NetworkName yourname password%0a```%0a %0aThen, reconnect the network by doing `/msg BouncerServ network update -network NetworkName`. %0a%0a## Client Compatibility%0aSoju require atleast IRCv3 supported client with `cap-3.2` support. See the [IRCv3 support tables](https://ircv3.net/software/clients) for a more general list of clients.%0a%0a## Also Read%0a- [soju(1)](https://soju.im/doc/soju.1.html)%0a- [soju - Getting started](https://git.sr.ht/~emersion/soju/tree/HEAD/item/doc/getting-started.md)%0a- [soju - Clients](https://git.sr.ht/~emersion/soju/tree/HEAD/item/contrib/clients.md)%0a- [catsit - process supervisor](https://git.causal.agency/catsit)%0a time=1648914367 author:1648914367=Yonle diff:1648914367:1648914367:minor=1,80d0%0a%3c ## Soju%0a%3c [Soju](https://soju.im) is A user-friendly IRC bouncer. Just like [ZNC](http://wiki.ircnow.org/index.php?n=Znc.Install), It runs on a server and stays connected after you turn off your computer or phone. It saves chat messages and replays them when you reconnect, and also helps to hide your IP address. If you are running it on IRCNow, your server may also offer DDoS protection to keep you online.%0a%3c %0a%3c ## Getting started%0a%3c Starting by compiling from source. You need `go` or `golang` installed for compiling soju, and `scdoc` for the documentation (optional).%0a%3c %0a%3c ### Getting source code from git repository%0a%3c Clone the repository with `git clone` command.%0a%3c %0a%3c ```%0a%3c cd ~%0a%3c git clone --depth=1 https://git.sr.ht/~emersion/soju%0a%3c ```%0a%3c %0a%3c ### Getting source code from release%0a%3c We're gonna fetch a tarball from upstream then extract them%0a%3c %0a%3c ```%0a%3c ftp https://git.sr.ht/~emersion/soju/refs/download/v0.4.0/soju-0.4.0.tar.gz%0a%3c tar -xvzf soju-0.4.0.tar.gz%0a%3c cd soju-0.4.0%0a%3c ```%0a%3c %0a%3c ### Compiling Soju%0a%3c When you've been fetch the source code, start compiling by typing `make`. Before begin compiling, make sure that `go` or `golang` is installed in your VPS.%0a%3c %0a%3c ```%0a%3c make%0a%3c ```%0a%3c %0a%3c When building is done, Run `doas make install` to install soju into your system.%0a%3c %0a%3c ## Configuration%0a%3c Soju has a small server configuration which is easy to configure.%0a%3c %0a%3c See [soju.1 - Config File](https://soju.im/doc/soju.1.html#CONFIG_FILE) for more information about configuration file.%0a%3c %0a%3c After configuring soju config file, Start by creating a bouncer user. You may specify `-admin` at the end for making the user as admin %0a%3c %0a%3c ```%0a%3c $ sojuctl create-user yourname -admin%0a%3c Password:%0a%3c ```%0a%3c %0a%3c In case if you want to change password, do `sojuctl change-password yourname`.%0a%3c %0a%3c ## Setting up & Connecting into network%0a%3c Start the server by executing `soju -config soju.conf`. Modify `soju.conf` into your config filename to use your config. %0a%3c %0a%3c Connect into your bouncer with these credential:%0a%3c %0a%3c SASL Username: yourname%0a%3c SASL Password: [your bouncer user password]%0a%3c SASL Mechanism: PLAIN%0a%3c %0a%3c Then, Add a network into your bouncer by messaging to `BouncerServ`%0a%3c %0a%3c ```%0a%3c /msg BouncerServ network create -addr irc.ircnow.org:6697 -name IRCNow%0a%3c ```%0a%3c %0a%3c After executing this command, You will be connected into your network. %0a%3c %0a%3c Optionally, You may also set SASL plain / external (certfp) authentication. %0a%3c %0a%3c For SASL Plain, You may do%0a%3c ```%0a%3c /msg BouncerServ sasl set-plain -network NetworkName yourname password%0a%3c ```%0a%3c %0a%3c Then, reconnect the network by doing `/msg BouncerServ network update -network NetworkName`. %0a%3c %0a%3c ## Client Compatibility%0a%3c Soju require atleast IRCv3 supported client with `cap-3.2` support. See the [IRCv3 support tables](https://ircv3.net/software/clients) for a more general list of clients.%0a%3c %0a%3c ## Also Read%0a%3c - [soju(1)](https://soju.im/doc/soju.1.html)%0a%3c - [soju - Getting started](https://git.sr.ht/~emersion/soju/tree/HEAD/item/doc/getting-started.md)%0a%3c - [soju - Clients](https://git.sr.ht/~emersion/soju/tree/HEAD/item/contrib/clients.md)%0a%3c - [catsit - process supervisor](https://git.causal.agency/catsit)%0a host:1648914367=182.1.47.69