Difference between revisions of "Znc"

From ArchWiki
Jump to: navigation, search
m (Bad URL too*)
m (Spelling)
(10 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[Category:Daemons and system services]]
 
 
[[Category:Internet Relay Chat]]
 
[[Category:Internet Relay Chat]]
'''ZNC''' is an advanced IRC bouncer that is left connected so an IRC client can disconnect/reconnect without loosing the chat session.
+
'''ZNC''' is an advanced IRC bouncer that is left connected so an IRC client can disconnect/reconnect without losing the chat session.
  
== Init script ==
+
== Installation ==
 +
1. Install {{pkg|znc}} from the [[Official Repositories]]. The installation script will create a group and user '''znc'''. The default home directory for this user is {{ic|/var/lib/znc}}.
  
By default, ZNC does not include an daemon init script (like those usually found in {{ic|/etc/rc.d/}}). It maybe preferable to run ZNC as a daemon:
+
{{Note| A bug in znc.install (znc 1.0-2) sets the znc user's home directory as {{ic|/var/empty}}. {{ic|/var/lib/znc}} is still created and owned by the correct user/group. You should change znc's home directory to {{ic|/var/lib/znc}}}}
  
1. Install:
+
2. Generate ZNC config as user '''znc'''.
 +
# su - znc
 +
$ znc --makeconf
 +
Go through the wizard and setup your preferences.
 +
{{warning|Do not edit configuration files manually in a text editor while ZNC is running. There is a very good chance you will lose your configuration. Use the webadmin or controlpanel modules to change settings on-the-fly. They are both included in the package.}}
  
  pacman -S znc
+
3. To make ZNC start on boot:
 +
  # systemctl enable znc
  
2. Create a znc group and user
+
Start and stop the ZNC daemon as usual by running:
  
  groupadd -r znc
+
  # systemctl {start|stop|restart} znc
useradd -r -g znc -d /var/lib/znc -s /bin/false -c znc znc
+
mkdir -p /var/lib/znc
+
chown znc:znc /var/lib/znc
+
  
3. Install rc.d and conf.d script:
+
== Configuration ==
 
+
Though you can choose to modify your configuration files manually, this requires shutting down the server first. '''Do not edit configuration files while ZNC is running'''.
wget -O /etc/rc.d/znc https://raw.github.com/kylef/ark/master/znc-system-wide/znc.rcd
+
wget -O /etc/conf.d/znc https://raw.github.com/kylef/ark/master/znc-system-wide/znc.conf
+
 
+
4. Generate ZNC config:
+
 
+
rc.d makeconf znc
+
 
+
To make ZNC start on boot, add ZNC to <code>DAEMONS</code> in <code>/etc/rc.conf</code>.
+
 
+
Start and stop the ZNC daemon as usual by running:
+
  
rc.d {start|stop|restart} znc
+
=== Webadmin Module ===
 +
If you enabled the web admin module, you can access it at {{ic|http://''yourhostname'':''znc port''}}, the znc port number is the same as you defined for connecting to the bouncer.
  
== External links ==
+
=== Control Panel Module ===
 +
If you enabled the control panel module, {{ic|/msg *controlpanel help}} for a list of settings while you are connected to the server.
  
* [http://wiki.znc.in/ZNC ZNC (website)]
+
== See also ==
 +
* [http://wiki.znc.in/ZNC ZNC's website]

Revision as of 20:40, 4 January 2013

ZNC is an advanced IRC bouncer that is left connected so an IRC client can disconnect/reconnect without losing the chat session.

Installation

1. Install znc from the Official Repositories. The installation script will create a group and user znc. The default home directory for this user is /var/lib/znc.

Note: A bug in znc.install (znc 1.0-2) sets the znc user's home directory as /var/empty. /var/lib/znc is still created and owned by the correct user/group. You should change znc's home directory to /var/lib/znc

2. Generate ZNC config as user znc.

# su - znc
$ znc --makeconf

Go through the wizard and setup your preferences.

Warning: Do not edit configuration files manually in a text editor while ZNC is running. There is a very good chance you will lose your configuration. Use the webadmin or controlpanel modules to change settings on-the-fly. They are both included in the package.

3. To make ZNC start on boot:

# systemctl enable znc

Start and stop the ZNC daemon as usual by running:

# systemctl {start|stop|restart} znc

Configuration

Though you can choose to modify your configuration files manually, this requires shutting down the server first. Do not edit configuration files while ZNC is running.

Webadmin Module

If you enabled the web admin module, you can access it at http://yourhostname:znc port, the znc port number is the same as you defined for connecting to the bouncer.

Control Panel Module

If you enabled the control panel module, /msg *controlpanel help for a list of settings while you are connected to the server.

See also