ULYSSIS public IRC: Difference between revisions

From ULYSSIS documentation
(Update introduction, start with web irc, add znc)
mNo edit summary
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
ULYSSIS hosts its own IRC server. IRC stands for Internet Relay Chat, [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC on wikipedia]. It is a chat protocol that mainly focuses on group chat, but also allows for private chat.
ULYSSIS hosts its own IRC network. IRC stands for Internet Relay Chat, [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC on wikipedia]. It is a chat protocol that mainly focuses on group chat, but also allows for private chat.


If you have an urgent question, IRC is often the quickest way to contact us. But also if you don't have a question and just want to hang out in our chat, feel free to join!
For any support questions, you are free to contact us via email on ulyssis@ulyssis.org, but if your questions are of a less sensitive nature and could benefit from a back-and-forth, it could be useful to contact us on IRC. Do keep in mind that you may have to wait until someone notices your question, which may take a while. If you don't have a question and just want to hang out in our chat, feel free to join!


==Using our web IRC client==
Keep in mind that our IRC network has been a social space for several generations, so you will find alumni and students from different walks of life there, not just ULYSSIS members and users.
If you won't regularly use our IRC or if you just want to check it out, you can use our web IRC client instead. You can find it at [https://webirc.ulyssis.org/ webirc.ulyssis.org].


==IRC server details==
==Web IRC client==
If you won't regularly use our IRC or if you just want to check it out, you can use our web IRC client. You can find it at [https://webirc.ulyssis.org/ webirc.ulyssis.org]. Remember to leave your web IRC browser tab open while you wait for a response.
 
==IRC network details==


Below are specific instructions for some clients, but if you are already familiar with IRC, here are the details you need to connect to our server. We highly recommend using SSL.
Below are specific instructions for some clients, but if you are already familiar with IRC, here are the details you need to connect to our server. We highly recommend using SSL.
Line 13: Line 15:
  Port: 6668 (SSL)
  Port: 6668 (SSL)
  Channel: #ulyssis
  Channel: #ulyssis
If <code>irc.ulyssis.org</code> is down, you can also try the other server in the same network, hosted at <code>irc2.ulyssis.org</code>. Both are connected to each other and you can use them interchangeably. It is advised to add it as a fallback in your IRC client.


==IRC clients==
==IRC clients==
Line 20: Line 24:
Screen and tmux are similar programs. Screen has been around for longer and is more tested, while tmux is more modern with new features and being easier to use for beginners.
Screen and tmux are similar programs. Screen has been around for longer and is more tested, while tmux is more modern with new features and being easier to use for beginners.


==Using irssi on our shell servers==
===Using irssi on our shell servers===
===Connect to the shellserver===
====Connect to the shellserver====
Use the ssh command in your Linux or OS X terminal, or use PuTTY to connect on windows.
Use the ssh command in your Linux or OS X terminal, or use PuTTY to connect on windows.
Extensive information on how to do so can be found on [[Accessing shell servers over SSH]].
Extensive information on how to do so can be found on [[Accessing shell servers over SSH]].


===Start irssi in a screen===
====Start irssi in a screen====
*When on the shellserver, enter <code>screen -U</code> to start a screen session, or <code>tmux</code> to start a tmux session.
*When on the shellserver, enter <code>screen -U</code> to start a screen session, or <code>tmux</code> to start a tmux session.
*Enter <code>irssi</code> to start irssi
*Enter <code>irssi</code> to start irssi
*Connect to the IRC server: <code>/server -ssl irc.ulyssis.org 6668</code>
*Connect to the IRC server: <code>/connect -ssl irc.ulyssis.org 6668</code>
*Connect to the public channel: <code>/join #ulyssis</code>
*Connect to the public channel: <code>/join #ulyssis</code>


===Screen usage===
====Screen usage====
*To exit the screen: press Ctrl-A and press D ('detach') to return to the shellserver.
*To exit the screen: press Ctrl-A and press D ('detach') to return to the shellserver.
*To reconnect: enter <code>screen -r</code> or <code>screen -DR</code> (the latter will create a new screen if it wasn't already made).
*To reconnect: enter <code>screen -r</code> or <code>screen -DR</code> (the latter will create a new screen if it wasn't already made).


===Tmux usage===
====Tmux usage====
*To exit the tmux session: press Ctrl-B and press D ('detach') to return to the shellserver.
*To exit the tmux session: press Ctrl-B and press D ('detach') to return to the shellserver.
*To reconnect: enter <code>tmux attach</code>
*To reconnect: enter <code>tmux attach</code>


===Help, I can't reconnect to my session!===
====Help, I can't reconnect to my session!====
*Check if you are on the right shell server and didn't make a typing error.
*Check if you are on the right shell server and didn't make a typing error.
*If everything is correct, your screen may have been stopped by a crash or a reboot of our shellserver. You can check the [http://www.ulyssis.org/status status] section of our website for more information about possible downtimes.
*If everything is correct, your screen may have been stopped by a crash or a reboot of our shellserver. You can check the [http://status.ulyssis.org status] section of our website for more information about possible downtimes.
*Make sure you use the right program (<code>screen</code> if you started a screen session and <code>tmux</code> if you started a tmux session)
*Make sure you use the right program (<code>screen</code> if you started a screen session and <code>tmux</code> if you started a tmux session)


Line 50: Line 54:


In your IRC client, connect to the server <code>znc.ulyssis.org</code> on port 6666 (with SSL) and set <code>username/network:password</code> as password to the server. Replace <code>username</code> with your ULYSSIS username, <code>network</code> with the name of the network in your znc settings, and <code>password</code> with your ULYSSIS password.
In your IRC client, connect to the server <code>znc.ulyssis.org</code> on port 6666 (with SSL) and set <code>username/network:password</code> as password to the server. Replace <code>username</code> with your ULYSSIS username, <code>network</code> with the name of the network in your znc settings, and <code>password</code> with your ULYSSIS password.
==Using Bitlbee==
With [https://www.bitlbee.org/main.php/news.r.html Bitlbee], you can connect to other services as if they were an IRC server. It is available at <code>bitlbee.ulyssis.org</code> on ports 7000 and 7001 (SSL). For documentation on how to use Bitlbee, we refer to the manual on its website. This service is only reachable from within the ULYSSIS and KU Leuven networks.
[[Category:Shell]]
[[Category:ULYSSIS Public Services]]

Latest revision as of 16:24, 11 April 2024

ULYSSIS hosts its own IRC network. IRC stands for Internet Relay Chat, IRC on wikipedia. It is a chat protocol that mainly focuses on group chat, but also allows for private chat.

For any support questions, you are free to contact us via email on ulyssis@ulyssis.org, but if your questions are of a less sensitive nature and could benefit from a back-and-forth, it could be useful to contact us on IRC. Do keep in mind that you may have to wait until someone notices your question, which may take a while. If you don't have a question and just want to hang out in our chat, feel free to join!

Keep in mind that our IRC network has been a social space for several generations, so you will find alumni and students from different walks of life there, not just ULYSSIS members and users.

Web IRC client

If you won't regularly use our IRC or if you just want to check it out, you can use our web IRC client. You can find it at webirc.ulyssis.org. Remember to leave your web IRC browser tab open while you wait for a response.

IRC network details

Below are specific instructions for some clients, but if you are already familiar with IRC, here are the details you need to connect to our server. We highly recommend using SSL.

Server: irc.ulyssis.org
Port: 6668 (SSL)
Channel: #ulyssis

If irc.ulyssis.org is down, you can also try the other server in the same network, hosted at irc2.ulyssis.org. Both are connected to each other and you can use them interchangeably. It is advised to add it as a fallback in your IRC client.

IRC clients

To use IRC, you'll need an IRC client. We advise the terminal based irssi or weechat for Linux and hexchat or mIRC for Windows, but there are a lot of other free options.

You can only receive messages over IRC while you're connected. Therefore, we advise you to run irssi or weechat in either a screen or a tmux session. With a ULYSSIS account, you can run screen or tmux on our shellservers, as they keep running 24/7 you can use them to keep track of your conversations. Screen and tmux are similar programs. Screen has been around for longer and is more tested, while tmux is more modern with new features and being easier to use for beginners.

Using irssi on our shell servers

Connect to the shellserver

Use the ssh command in your Linux or OS X terminal, or use PuTTY to connect on windows. Extensive information on how to do so can be found on Accessing shell servers over SSH.

Start irssi in a screen

  • When on the shellserver, enter screen -U to start a screen session, or tmux to start a tmux session.
  • Enter irssi to start irssi
  • Connect to the IRC server: /connect -ssl irc.ulyssis.org 6668
  • Connect to the public channel: /join #ulyssis

Screen usage

  • To exit the screen: press Ctrl-A and press D ('detach') to return to the shellserver.
  • To reconnect: enter screen -r or screen -DR (the latter will create a new screen if it wasn't already made).

Tmux usage

  • To exit the tmux session: press Ctrl-B and press D ('detach') to return to the shellserver.
  • To reconnect: enter tmux attach

Help, I can't reconnect to my session!

  • Check if you are on the right shell server and didn't make a typing error.
  • If everything is correct, your screen may have been stopped by a crash or a reboot of our shellserver. You can check the status section of our website for more information about possible downtimes.
  • Make sure you use the right program (screen if you started a screen session and tmux if you started a tmux session)

Using ZNC

Alternatively, if you don't like using terminal-based clients, or just want to run your client locally, you can connect with our ZNC server. However, to use it, you'll need a ULYSSIS account. ZNC connects to our IRC server in your place (fill in the details at the beginning of this article). You can then connect to ZNC with a client of your choice, and it will send you the history you've missed while you were offline.

Log in to our ZNC server. In your settings, create a new network. Fill in the basic details (server name, nickname, set BindHost to 0.0.0.0). In the server field, fill in irc.ulyssis.org +6668. Add #ulyssis as a channel. You may want to increase the buffer count. Then save at the bottom of the page.

In your IRC client, connect to the server znc.ulyssis.org on port 6666 (with SSL) and set username/network:password as password to the server. Replace username with your ULYSSIS username, network with the name of the network in your znc settings, and password with your ULYSSIS password.

Using Bitlbee

With Bitlbee, you can connect to other services as if they were an IRC server. It is available at bitlbee.ulyssis.org on ports 7000 and 7001 (SSL). For documentation on how to use Bitlbee, we refer to the manual on its website. This service is only reachable from within the ULYSSIS and KU Leuven networks.