Setup IRC¶

IRC¶

What is IRC?¶

The OpenStack community uses Internet Relay Chat (IRC), an open source protocol, as its primary chat service.

IRC allows you to:

Communicate with project teams, the technical committee, SIGs, and other Working Groups.
Participate in regular meetings with the above groups.

What IRC network we use¶

The OpenStack Community is using the OFTC IRC network.

Set up IRC on Linux & Windows¶

Install an IRC Program¶

This section explains how you can install an IRC program called Hexchat.

For a Linux distributions like Debian, Ubuntu, or Mint open a terminal and type:

sudo apt install hexchat

For Linux distributions like Redhat, Fedora, or CentOS open a terminal and type:

sudo dnf install hexchat

For a Windows environment, download the latest Hexchat installation binary from Hexchat download and install it.

Now open the hexchat program just like you would for any Linux program.

Edit Nick Name Settings¶

Lets first fill out the Nick name and User name field with our choice of a nickname:
From the list of Networks you should select OFTC network.

ircs://irc.oftc.net:6697 for SSL (alternative port: 9999), IPv4 and IPv6.
irc://irc.oftc.net:6667 for non-SSL (alternative ports: 6668-6670, 7000), IPv4 and IPv6.

Edit Server Settings¶

Click the edit button and
Make sure that Use SSL for all the servers on this network is checked.

Troubleshooting¶

If you get a notice that the nick name is already taken, quit and go back to the first set of steps to pick a different nickname.

Register Your Nick Name¶

If you don’t already have an account, you can register one with /msg NickServ REGISTER <password> <e-mail>. The OFTC Guide will guide you through the rest of the registration process. Make sure to follow the instructions and complete the verification process.

When you login to the server for the first time with your nickname, it will be used by you, but it’s still not registered yet.

In order to register you need to send a message to nickserv on OFTC, which is a bot that allows you to register and identify yourselves as the owner of a nick name.

If all goes well you should receive a message back instantly that the nick name is registered by you and an activation email will be sent to the email address you provided.

Auto-Login On Connecting To OFTC¶

In order to identify yourselves that you own the nick name upon logging in, you need to tell Hexchat to communicate your password upon connecting.

Click Hexchat from the menu and then click Network List. You will see a familiar first screen of servers listed. Make sure OFTC is highlighted and click edit.
In the Password put in the password you picked in the previous step and click close.

In case of more question about OFTC, read these FAQs

Done¶

Congratulations you’re now ready to communicate with the OpenStack community and have a registered nick name on OFTC! From here on out when you connect to OFTC with Hexchat you will be identified with your nickname.

A good channel to join right away is the #openstack-dev channel. A lot of people hang around in that channel so come on in and say hello! If there is a specific project you are also interested in working on, feel free to join that one as well and introduce yourself there. Interested in joining more channels or need to look up what one is called? Check out IRC Channels for more information.

It’s also important to note that contributors are located all over the world across different time zones, so channels may be quieter outside of their work hours. Be patient when asking questions, and it might be a while before someone responds. Additionally, keep in mind that IRC does not natively support a message backlog, so you may miss messages sent while you were disconnected. Many contributors keep a persistent IRC session to avoid missing important communications, and IRC Archives can be helpful for catching up on missed messages.

Set up IRC on Mac OS¶

#irchelp describes available IRC client programs for Mac OS environment. LimeChat provides an installation binary for you to download, install, and configure to connect to OFTC.

IRC Chatting with Matrix¶

You can also use IRC chat with Matrix. The Zuul community described how to use Matrix to bridge into OFTC IRC. If you want to use Matrix as a IRC client, please follow this link:

https://zuul-ci.org/docs/zuul/latest/howtos/matrix.html.

IRC Channels¶

Each project and working group has its own IRC channel. The common syntax for naming the IRC channels is: #openstack-<name-of-project>, but there are some exceptions. See the contributor guide for each project for specific information. If you fail to find a reference there, don’t hesitate to ask in the general #openstack-dev channel.

IRC Meetings¶

In OpenStack all the meetings are happening either on generic meeting channels channels like #openstack-meeting, or on specific project channels. Check the list of meetings for meeting times, IRC channels, and archives of meetings.

IRC Archives¶

Most IRC channels are archived, you can read the logs on IRC channel logs.

IRC bots¶

IRC allows different programs to listen to the IRC channels and do some actions. These programs are called IRC bots. There are several bots used in the OpenStack IRC channels, this section contains the ones which are useful from the first days of OpenStack development. A more comprehensive list can be found in the OpenDev team IRC page.

Thanksbot¶

This bot allows people to recognize each other and be thankful. Anyone can post a message in the OpenStack IRC channels to say thanks. The way to say thanks is:

#thanks <irc_nick> <message>

The irc_nick is the IRC nick of the person who is receiving the thanks. The message is a short text to explain the reason for the thanks. The bot collects all thanks to a wiki page.

Statusbot¶

Statusbot is used to distribute urgent information from the OpenDev team to OpenStack channels.

Successbot¶

Successbot is an IRC bot to express small successes in OpenStack development. To celebrate in the OpenStack IRC channel way just type:

#success <message>

to any OpenStack IRC channel where the Statusbot is listening. The message will be posted to the Successes wiki page.

Setup IRC