How do I manually edit my ZNC configuration file (znc.conf)?

Prefer webadmin (or /msg *status / controlpanel) while ZNC is running. Do not edit znc.conf live and hope.

File: ~/.znc/configs/znc.conf

If you must edit by hand

  1. Flush runtime config to disk:

pkill -SIGUSR1 znc ` Same as /msg *status saveconfig`.

  1. Stop ZNC:

pkill znc ` Or kill the pid from ps x` (see restart).

  1. Edit:

nano ~/.znc/configs/znc.conf

  1. Start:

znc

Do not pkill -SIGHUP znc as a habit (rehash). It can go badly. Stop, edit, start.

What you actually change in there

  • Listen / Port / SSL
  • BindHost (vhost) — user and/or network. Must be in the global allowed BindHost list.
  • LoadModule = webadmin
  • LoadModule = playback
  • <Pass ...> block — better to run znc --makepass and paste; password reset
  • <Network> server lines

Syntax errors = ZNC refuses to start and says so. Keep a copy: cp ~/.znc/configs/znc.conf ~/.znc/configs/znc.conf.bak.

Client settings after a bind/ident change: Connecting your IRC client to ZNC.

  • 5 Users Found This Useful
Was this answer helpful?

Related Articles

How to install and configure a ZNC IRC Bouncer

ZNC 1.8.0 is already at /usr/local/bin/znc on KIRE. --makeconf is valid. SSH in. It daemonizes....

How to install and configure a psybnc IRC bouncer

psyBNC still works. SSH in. It daemonizes. Screen/tmux are for irssi/weechat. cd ~ wget...

How do I reset my ZNC IRC Bouncer password from Shell or SSH?

SSH in. znc --makepass still works on the box ZNC (1.8.0). znc --makepass Type the new password...

How do I restart my ZNC IRC bouncer?

SSH in. ZNC daemonizes; you do not keep it in screen. Start znc If you see ZNC is already running...

How do I connect to the psyBNC after its installed?

From your IRC client: /server bnc.kire.net:PORT /quote pass YOURPASS PORT is whatever you set in...