Documentation

Difference between revisions of "ULYSSIS public IRC"

(Start irssi in a screen)
(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])
+
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.
  
==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!
 +
 
 +
==Using our 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].
 +
 
 +
==IRC server 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.
  
IRC is a chat protocol. 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)
 
  Port: 6668 (SSL)
 
  Channel: #ulyssis
 
  Channel: #ulyssis
  
To use IRC you'll need an IRC client, we advise the terminal based [https://irssi.org/ irssi] 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.
+
==IRC clients==
 
+
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 our 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].
 
 
 
==Using irssi in a screen or tmux session==
 
  
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.
+
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.
 
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===
 
===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.
Line 41: Line 43:
 
*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.
 
*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.

Revision as of 01:23, 24 November 2018

ULYSSIS hosts its own IRC server. 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!

Using our 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 webirc.ulyssis.org.

IRC server 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

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.