ZNC - Revision history

Martyb: Added link to the SoylentNews IRC page

2020-05-09T14:04:29Z

Added link to the SoylentNews IRC page

← Older revision		Revision as of 14:04, 9 May 2020
Line 1:		Line 1:
	SoylentNews runs its own IRC bouncer (ZNC) for staff use.		SoylentNews runs its own IRC bouncer (ZNC) for staff use. (See the SoylentNews [[SoylentNews:IRC\|IRC Page]] for background information on IRC and our SoylentNews IRC (Internet Relay Chat) server.)

	== What is an IRC bouncer? ==		== What is an IRC bouncer? ==

Juggs: /* ZNC Settings Inheritance */

2015-11-19T04:00:43Z

ZNC Settings Inheritance

← Older revision		Revision as of 04:00, 19 November 2015
Line 11:		Line 11:
	<p>As a user of ZNC you will find 3 levels of configuration options. Your Settings > Network Settings > Channel Settings.</p>		<p>As a user of ZNC you will find 3 levels of configuration options. Your Settings > Network Settings > Channel Settings.</p>
	<p>Settings inherit from left to right in that list. i.e. if you check a module on in Your Settings it will be on in any Network or Channel you add. Hence if you are using ZNC to connect to multiple IRC networks, you probably want to keep Your Settings to a minimum and configure things on a per Network or Channel basis e.g. to be sane about the amount of scrollback you get on a busy Network or Channel. You can override this inheritance at any time by specifying details at the lower level.</p>		<p>Settings inherit from left to right in that list. i.e. if you check a module on in Your Settings it will be on in any Network or Channel you add. Hence if you are using ZNC to connect to multiple IRC networks, you probably want to keep Your Settings to a minimum and configure things on a per Network or Channel basis e.g. to be sane about the amount of scrollback you get on a busy Network or Channel. You can override this inheritance at any time by specifying details at the lower level.</p>
	<p>n.b. If you use the chansaver module, you never need to bother with the Channel level stuff, chansaver remembers what channels you are in on any given network and maintains connection there, so there is no need to go to that level of ~~grabularity~~ unless you really want to.</p>		<p>n.b. If you use the chansaver module, you never need to bother with the Channel level stuff, chansaver remembers what channels you are in on any given network and maintains connection there, so there is no need to go to that level of granularity unless you really want to.</p>
	<p>The following sections assume you will just be using the SN bouncer to connect to SN IRC, so a lot is placed into the top level settings. If you wish to connect to other Networks using the SN bouncer, you're free to do so, but note you will need to customise your nickserv settings at the Network level for each</p>		<p>The following sections assume you will just be using the SN bouncer to connect to SN IRC, so a lot is placed into the top level settings. If you wish to connect to other Networks using the SN bouncer, you're free to do so, but note you will need to customise your nickserv settings at the Network level for each</p>

Juggs at 03:23, 4 July 2015

2015-07-04T03:23:14Z

← Older revision		Revision as of 03:23, 4 July 2015
Line 7:		Line 7:
	== What is ZNC? ==		== What is ZNC? ==
	ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.		ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.

			== ZNC Settings Inheritance ==
			<p>As a user of ZNC you will find 3 levels of configuration options. Your Settings > Network Settings > Channel Settings.</p>
			<p>Settings inherit from left to right in that list. i.e. if you check a module on in Your Settings it will be on in any Network or Channel you add. Hence if you are using ZNC to connect to multiple IRC networks, you probably want to keep Your Settings to a minimum and configure things on a per Network or Channel basis e.g. to be sane about the amount of scrollback you get on a busy Network or Channel. You can override this inheritance at any time by specifying details at the lower level.</p>
			<p>n.b. If you use the chansaver module, you never need to bother with the Channel level stuff, chansaver remembers what channels you are in on any given network and maintains connection there, so there is no need to go to that level of grabularity unless you really want to.</p>
			<p>The following sections assume you will just be using the SN bouncer to connect to SN IRC, so a lot is placed into the top level settings. If you wish to connect to other Networks using the SN bouncer, you're free to do so, but note you will need to customise your nickserv settings at the Network level for each</p>

	== Setting up ZNC - for Staff ==		== Setting up ZNC - for Staff ==
	<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with nickserv, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>		<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with nickserv, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>

			=== Your Settings ===
	* An IRC Admin will notify you of your ZNC username and initial password.		* An IRC Admin will notify you of your ZNC username and initial password.
	* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.		* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.
Line 29:		Line 37:
	<p></p>		<p></p>

			=== Add the SN IRC Server as a Network ===
			* First thing to note here - as soon as you hit Save in this part of the configuration, ZNC will attempt to connect as you, using your nickserv auth details, so it is imperative to drop your direct IRC Client connection before doing so.
			* Go To Your Settings and hit the Add link in the Networks section. Name it Soylent for the purposes of this article... this comes in later.
			* If you populated your SN IRC details at the Your Settings level you can leave much of this blank (inheritance remember). But feel free to populate the Top fields again if it satisfies an OCD itch.
			* Make sure BindHost is set to ::1, Active: "Connect to IRC & automatically re-connect is checked, add ::1 +6697 in the "Servers of this IRC network:" box, set Flood Protection as you wish, it's self explanatory.
			* Scroll down to Modules, at a minimum you will want chansaver, keepnick and nickserv checked. Copy / pasta your nickserv password into the box to the right of the nickserv checkbox so ZNC can authenticate as you.
			* Disconnect your direct IRC Client > SN IRC server connection, then hit Save in the ZNC interface.
			* All being well, at this point ZNC connects as you to the SN IRC server and sits amiably at the server channel only.

			=== Connecting your IRC Client to the Bouncer ===
			<p>This section is unspecific as it is client dependent, but it basically involves adding a new connection in your IRC client. It's just the usual stuff you would configure for any new IRC network you connect to. Below are the quirks for Hexchat.</p>
			<nowiki>Servers tab: irc.soylentnews.org/60000
			Check - Use SSL for all the servers on this network
			Check - Accept invalid SSL certificates (self-signed cert) - Hexchat farts on self-signed certs.
			Nick name: $YourZNCUserName$/Soylent (Obviously substitute your ZNC username in there)
			User name: $YourZNCUserName$/Soylent (Obviously substitute your ZNC username in there)
			Password: $Your ZNC passwd$
			</nowiki>

			* At this point you should be able to connect your IRC client to the new network you just setup and find it sitting in the server channel. If you got that far all you have to do is /j #channels to get the bouncer into your usual channels.

			* Henceforth when you disconnect your client from the bouncer, the bouncer will will stay in channel for you (you can use the auto-away module if you want) and play back what went on in your abscence on re-connect.

	~~THIS ARTICLE NEEDS A LOT OF WORK STILL~~! :D		* If you got this far, good work! It all slots into place once you have one network up and running. Now you are free to configure ZNC to your whims either by the web interface or by entering /znc while connected via the SN bouncer. You will get a PM from "status" - this article will not cover ZNC configuration via that method.

Crutchy: Undo revision 9062 by Exec (talk)

2015-06-23T06:08:15Z

Undo revision 9062 by Exec (talk)

← Older revision		Revision as of 06:08, 23 June 2015
Line 1:		Line 1:
	~~{{spam}}~~		SoylentNews runs its own IRC bouncer (ZNC) for staff use.

			== What is an IRC bouncer? ==
			<p>An IRC bouncer is benign. It acts as your proxy to IRC servers of your choice, a concierge if you will. While you are away, the bouncer stays connected to all your IRC networks and channels as your representative then (optionally) tells you everything that went on while you were away.</p>
			<p>Rather than your connection to an IRC server being client >> IRC server(s) it becomes client >> Bouncer >> IRC server(s). The nice thing is the bouncer never sleeps so Bouncer >> IRC server(s) is always maintained, the client can come and go at will. When you reconnect your IRC client to the Bouncer you can (optionally) get scrollback for all the channels you were in prior to your client disconnection.</p>

			== What is ZNC? ==
			ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.

			== Setting up ZNC - for Staff ==
			<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with nickserv, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>
			* An IRC Admin will notify you of your ZNC username and initial password.
			* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.
			* Go to Your Settings in the right hand menu and change your password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.
			* Probably want to go ahead and Logout & log back in with your new password at this point.
			<p></p>
			* Return to Your Settings and populate the IRC Information section (same kind of info you'd use in an IRC client).
			* Scroll down to the Modules section - as a minimum you probably want chansaver and ctcpflood checked, you may want to check some of the others n.b. the name of each module is clickable to bring up a ZNC wiki page on what they each do.
			* Further down the page still, in Flags - you probably want to check Prepend Timestamps - this prepends played back messages with their time/date on client reconnection after a time away.
			* Nearly done - ZNC Behaviour section - probably want to set a Timezone there so replayed messages carry your localised time rather than UTC. You can also have some fun with CTCP replies. e.g.
			<nowiki>CLIENTINFO No
			FINGER Kinky
			PING No
			TIME No
			USERINFO No
			VERSION No
			</nowiki>
			* Finally... hit Save :)
			<p></p>








			THIS ARTICLE NEEDS A LOT OF WORK STILL! :D

Exec: Replaced content with "{{spam}}"

2015-06-23T06:07:15Z

Replaced content with "{{spam}}"

← Older revision		Revision as of 06:07, 23 June 2015
Line 1:		Line 1:
	~~SoylentNews runs its own IRC bouncer (ZNC) for staff use.~~		{{spam}}

	~~== What is an IRC bouncer? ==~~
	<p>An IRC bouncer is benign. It acts as your proxy to IRC servers of your choice, a concierge if you will. While you are away, the bouncer stays connected to all your IRC networks and channels as your representative then (optionally) tells you everything that went on while you were away.</p>
	<p>Rather than your connection to an IRC server being client >> IRC server(s) it becomes client >> Bouncer >> IRC server(s). The nice thing is the bouncer never sleeps so Bouncer >> IRC server(s) is always maintained, the client can come and go at will. When you reconnect your IRC client to the Bouncer you can (optionally) get scrollback for all the channels you were in prior to your client disconnection.</p>

	~~== What is ZNC? ==~~
	ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.

	~~== Setting up ZNC - for Staff ==~~
	<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with nickserv, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>
	* An IRC Admin will notify you of your ZNC username and initial password.
	* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.
	* Go to Your Settings in the right hand menu and change your password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.
	* Probably want to go ahead and Logout & log back in with your new password at this point.
	~~<p></p>~~
	* Return to Your Settings and populate the IRC Information section (same kind of info you'd use in an IRC client).
	* Scroll down to the Modules section - as a minimum you probably want chansaver and ctcpflood checked, you may want to check some of the others n.b. the name of each module is clickable to bring up a ZNC wiki page on what they each do.
	* Further down the page still, in Flags - you probably want to check Prepend Timestamps - this prepends played back messages with their time/date on client reconnection after a time away.
	* Nearly done - ZNC Behaviour section - probably want to set a Timezone there so replayed messages carry your localised time rather than UTC. You can also have some fun with CTCP replies. e.g.
	~~<nowiki>CLIENTINFO No~~
	~~FINGER Kinky~~
	~~PING No~~
	~~TIME No~~
	~~USERINFO No~~
	~~VERSION No~~
	~~</nowiki>~~
	* Finally... hit Save :)
	~~<p></p>~~








	~~THIS ARTICLE NEEDS A LOT OF WORK STILL! :D~~

Juggs at 03:55, 14 June 2015

2015-06-14T03:55:47Z

← Older revision		Revision as of 03:55, 14 June 2015
Line 12:		Line 12:
	* An IRC Admin will notify you of your ZNC username and initial password.		* An IRC Admin will notify you of your ZNC username and initial password.
	* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.		* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.
	* Go to Your Settings in the right hand menu and change ~~you~~ password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.		* Go to Your Settings in the right hand menu and change your password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.
	* Probably want to go ahead and Logout & log back in with your new password at this point.		* Probably want to go ahead and Logout & log back in with your new password at this point.
	<p></p>		<p></p>

Juggs at 03:25, 14 June 2015

2015-06-14T03:25:20Z

← Older revision		Revision as of 03:25, 14 June 2015
Line 14:		Line 14:
	* Go to Your Settings in the right hand menu and change you password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.		* Go to Your Settings in the right hand menu and change you password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.
	* Probably want to go ahead and Logout & log back in with your new password at this point.		* Probably want to go ahead and Logout & log back in with your new password at this point.
			<p></p>
			* Return to Your Settings and populate the IRC Information section (same kind of info you'd use in an IRC client).
			* Scroll down to the Modules section - as a minimum you probably want chansaver and ctcpflood checked, you may want to check some of the others n.b. the name of each module is clickable to bring up a ZNC wiki page on what they each do.
			* Further down the page still, in Flags - you probably want to check Prepend Timestamps - this prepends played back messages with their time/date on client reconnection after a time away.
			* Nearly done - ZNC Behaviour section - probably want to set a Timezone there so replayed messages carry your localised time rather than UTC. You can also have some fun with CTCP replies. e.g.
			<nowiki>CLIENTINFO No
			FINGER Kinky
			PING No
			TIME No
			USERINFO No
			VERSION No
			</nowiki>
			* Finally... hit Save :)
			<p></p>

Juggs at 02:50, 14 June 2015

2015-06-14T02:50:47Z

← Older revision		Revision as of 02:50, 14 June 2015
Line 6:		Line 6:

	== What is ZNC? ==		== What is ZNC? ==
	ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with ~~PsyBNC~~ [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.		ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.

	== Setting up ZNC - for Staff ==		== Setting up ZNC - for Staff ==
	<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with ~~chanserv~~, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>		<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with nickserv, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>
	~~<p>~~An IRC Admin will notify you of your ZNC username and initial password.</p>		* An IRC Admin will notify you of your ZNC username and initial password.
			* Go to [https://irc.soylentnews.org:60000/ SN ZNC Web Interface] with a web browser and login with your shiny new ZNC credentials.
			* Go to Your Settings in the right hand menu and change you password in the subsequent screen by populating the Password and Confirm password fields, scroll all the way down and hit Save.
			* Probably want to go ahead and Logout & log back in with your new password at this point.


	THIS IS ARTICLE NEEDS A LOT OF WORK STILL! :D



			THIS ARTICLE NEEDS A LOT OF WORK STILL! :D

Juggs: /* Setting up ZNC - for Staff */

2015-06-14T02:11:20Z

Setting up ZNC - for Staff

← Older revision		Revision as of 02:11, 14 June 2015
Line 9:		Line 9:

	== Setting up ZNC - for Staff ==		== Setting up ZNC - for Staff ==
	<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered and are SN staff.. so let's get on with the nuts and bolts... </p>		<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered with chanserv, have an irc client (rather than using the web interface) and are SN staff.. so let's get on with the nuts and bolts... </p>
	<p>An IRC Admin will notify you of your ZNC username and initial password</p>		<p>An IRC Admin will notify you of your ZNC username and initial password.</p>

	THIS IS ARTICLE NEEDS A LOT OF WORK STILL! :D		THIS IS ARTICLE NEEDS A LOT OF WORK STILL! :D

Juggs: /* Setting up ZNC for Staff */

2015-06-14T02:10:10Z

Setting up ZNC for Staff

← Older revision		Revision as of 02:10, 14 June 2015
Line 8:		Line 8:
	ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with PsyBNC [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.		ZNC is a popular IRC bouncer. See [http://wiki.znc.in/ZNC ZNC] Along with PsyBNC [http://www.psybnc.at/ psyBNC] these two are the most commonly used IRC Bouncers. psyBNC seems unmaintained right now unfortunately.

	== Setting up ZNC for Staff ==		== Setting up ZNC - for Staff ==
	<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered and are SN staff.. so let's get on with the nuts and bolts... </p>		<p>Assumptions at this point are that you have a SoylentNews IRC nick, have it registered and are SN staff.. so let's get on with the nuts and bolts... </p>
	<p>An IRC Admin will notify you of your ZNC username and initial password</p>		<p>An IRC Admin will notify you of your ZNC username and initial password</p>

	THIS IS ARTICLE NEEDS A LOT OF WORK STILL! :D		THIS IS ARTICLE NEEDS A LOT OF WORK STILL! :D