Documentation

Difference between revisions of "ULYSSIS public IRC"

 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
ULYSSIS hosts its own IRC server. (IRC stands for Internet Relay Chat, [http://en.wikipedia.org/wiki/Internet_Relay_Chat IRC on wikipedia])
+
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.
  
==Contact us on IRC==
+
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 [https://webirc.ulyssis.org/ 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.
  
The public channel is simply called ulyssis, if you have a question, you can use IRC as a fast way to contact us.
 
Details:
 
 
  Server: irc.ulyssis.org
 
  Server: irc.ulyssis.org
 +
Port: 6668 (SSL)
 
  Channel: #ulyssis
 
  Channel: #ulyssis
  
To use IRC you'll need an IRC client, we advise the terminal based [http://irssi.org/ irssi] for Linux (just use sudo apt-get install) and [http://www.mirc.com/ mIRC] for Windows, but there are a lot of other free options.
+
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.
  
==Using our web IRC client==
+
==IRC clients==
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].
+
To use IRC, you'll need an IRC client. We advise the terminal based [https://irssi.org/ irssi] or [https://weechat.org/ weechat] for Linux and [https://hexchat.github.io/ hexchat] or [https://www.mirc.com/ mIRC] for Windows, but there are a lot of other free options.
  
==Using irssi in a Screen==
+
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.
 
 
Our IRC server isn't very crowded and as you only see messages when you're connected, we advise you to run irssi in either a screen or a tmux session. Members 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.
 
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.
  
===Connect to the shellserver===
+
===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.
 
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</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 irc.ulyssis.org</code>
+
*Connect to the IRC server: <code>/server -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 shellserver 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 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.
 
*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)
 +
 +
==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 [https://znc.ulyssis.org/ 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 <code>BindHost</code> to <code>0.0.0.0</code>). In the server field, fill in <code>irc.ulyssis.org +6668</code>. Add <code>#ulyssis</code> 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 <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.

Latest revision as of 00: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.