Documentation

Difference between revisions of "ULYSSIS public IRC"

(Update introduction, start with web irc, add znc)
 
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!
 
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!
  
==Using our web IRC client==
+
==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 instead. You can find it at [https://webirc.ulyssis.org/ webirc.ulyssis.org].
+
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].
  
==IRC server details==
+
==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 13:
 
  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 22:
 
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
Line 31: Line 33:
 
*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://www.ulyssis.org/status status] section of our website for more information about possible downtimes.

Latest revision as of 01:31, 24 November 2018

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.

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!

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.

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: /server -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.