Created: 2008-11-12 07:47
Updated: 2016-05-08 16:44
License: gpl-2.0



irc-logger is IRC (Internet Reley Chat) logging and searching engine! It is complete merb application which you can use on your own domain.

How to install


System depenendencies

Ruby Gems


  1. Make sure that you have installed dependencies
  2. Create database (currently supported only PostgreSQL - you can try with others on you own risk)
  3. Get the sources git clone git:// or download the stable version
  4. Create directories mkdir tmp var
  5. Configure irc-logger
    • Copy config/database.example.yml to config/database.yml
      • Set there hostname, username, password, database name
    • Copy config/sphinx.example.conf to config/sphinx.conf
      • Set there hostname, username, password, database name
    • Set memcache servers in config/cache.yml
      • If you want you can change caching times (in seconds)
    • Configure bot listeners (copy config/bot.example.yml to config/bot.yml(
      • Set starling server
      • Add listeners names, nicknames, passwords and emails
        • Irc-logger will register nickname
        • Remember to pass valid and unique email, because some servers like to check this
    • Add database indexing to cron rake sphinx:delta sphinx:merge
  6. Initialize database rake db:automigrate.
  7. Initialize sphinx rake sphinx:setup
  8. Initialize sphinx index rake sphinx:main
  9. Add some channels using rake irc:join
  10. Configure web server (irc-logger is Rack application)


  1. Run memcache server
  2. Run starling server
  3. Run irc listeners rake irc:listener name=my_listener_0 (to stop them see next point)
  4. Run irc logging rake irc:listen - to disable kill this process (^C) and run rake irc:stop to disable listeners
  5. Run sphinx searching deamon rake sphinx:listen - to stop run rake sphinx:stop
  6. That's all - make sure that web server is working!


irc-logger - IRC logging and searching engine Copyright (C) 2008 Amadeusz Jasak

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


If you have questions write to Amadeusz Jasak (the author). Please donate!

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more