ZNC - Revision history

Klinger at 20:35, 24 April 2024

2024-04-24T20:35:43Z

← Older revision		Revision as of 20:35, 24 April 2024
Line 58:		Line 58:
	};		};
	</syntaxhighlight>		</syntaxhighlight>
			[[Category:Applications]]

imported>Mbwk: amend example to use nickserv module properly

2024-02-25T02:06:41Z

amend example to use nickserv module properly

← Older revision		Revision as of 02:06, 25 February 2024
Line 49:		Line 49:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	service.znc.config.User.bob = {		service.znc.config.User.bob = {
	Network.freenode = { ~~# The nickserv module will~~		Network.freenode = {
	Server = "chat.freenode.net +6697 ~~yourpassword~~"; ~~# <- pick up your password here.~~		Server = "chat.freenode.net +6697";
	Chan = { "#nixos" = {}; "#nixos-wiki" = {}; };		Chan = { "#nixos" = {}; "#nixos-wiki" = {}; };
	Nick = "bob";		Nick = "bob"; # Supply your password as an argument
	LoadModule = [ "nickserv" ];		LoadModule = [ "nickserv yourpassword" ]; # <- to the nickserv module here.
	JoinDelay = 2; # Avoid joining channels before authenticating.		JoinDelay = 2; # Avoid joining channels before authenticating.
	};		};
	};		};
	</syntaxhighlight>		</syntaxhighlight>

imported>Mth: znc --makepass generates a hash, not a password

2019-04-12T18:37:52Z

znc --makepass generates a hash, not a password

← Older revision		Revision as of 18:37, 12 April 2019
Line 17:		Line 17:
	==Clients==		==Clients==

	~~Generate~~ a password with:		Choose a password, and extract a hash with:
	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	$ nix-shell --packages znc --command "znc --makepass"		$ nix-shell --packages znc --command "znc --makepass"
Line 29:		Line 29:
	Admin = true;		Admin = true;
	Pass.password = {		Pass.password = {
	Method = "sha256"; # Fill out this section ~~with the generated password.~~		Method = "sha256"; # Fill out this section
	Hash = "...";		Hash = "..."; # with the generated hash.
	Salt = "...";		Salt = "...";
	};		};

imported>Mth at 17:18, 12 April 2019

2019-04-12T17:18:42Z

← Older revision		Revision as of 17:18, 12 April 2019
Line 15:		Line 15:
	And use <code>services.znc.config</code> to configure ZNC as described in [https://wiki.znc.in/Configuration Configuration] on the ZNC wiki.		And use <code>services.znc.config</code> to configure ZNC as described in [https://wiki.znc.in/Configuration Configuration] on the ZNC wiki.

	=Clients=		==Clients==

	Generate a password with:		Generate a password with:
Line 44:		Line 44:
	Next, see [https://wiki.znc.in/Connecting_to_ZNC Connecting] and [https://wiki.znc.in/Category:Clients Category:Clients] on the ZNC wiki.		Next, see [https://wiki.znc.in/Connecting_to_ZNC Connecting] and [https://wiki.znc.in/Category:Clients Category:Clients] on the ZNC wiki.

	=Networks=		==Networks==
	SASL authentication is not yet supported from <code>configuration.nix</code>. Either <code>/msg *sasl</code> <ref>See [https://wiki.znc.in/Sasl Sasl] on the ZNC wiki.</ref> or use NickServ instead as shown below.		SASL authentication is not yet supported from <code>configuration.nix</code>. Either <code>/msg *sasl</code> <ref>See [https://wiki.znc.in/Sasl Sasl] on the ZNC wiki.</ref> or use NickServ instead as shown below.

imported>Mth at 17:17, 12 April 2019

2019-04-12T17:17:10Z

← Older revision		Revision as of 17:17, 12 April 2019
Line 9:		Line 9:
	mutable = false; # Overwrite configuration set by ZNC from the web and chat interfaces.		mutable = false; # Overwrite configuration set by ZNC from the web and chat interfaces.
	useLegacyConfig = false; # Turn off services.znc.confOptions and their defaults.		useLegacyConfig = false; # Turn off services.znc.confOptions and their defaults.
			openFirewall = true; # ZNC uses TCP port 5000 by default.
	};		};
	</syntaxhighlight>		</syntaxhighlight>
Line 14:		Line 15:
	And use <code>services.znc.config</code> to configure ZNC as described in [https://wiki.znc.in/Configuration Configuration] on the ZNC wiki.		And use <code>services.znc.config</code> to configure ZNC as described in [https://wiki.znc.in/Configuration Configuration] on the ZNC wiki.

	==Clients==		=Clients=

	Generate a password with:		Generate a password with:
Line 23:		Line 24:
	Then, in <code>configuration.nix</code>:		Then, in <code>configuration.nix</code>:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	services.znc ~~= {~~		services.znc.config = {
	~~# ..~~.		LoadModule = [ "adminlog" ]; # Write access logs to ~znc/moddata/adminlog/znc.log.
	~~openFirewall = true;~~		User.bob = {
	config = {		Admin = true;
	LoadModule = [ "adminlog" ]; # Write logs to ~znc/moddata/adminlog/znc.log.		Pass.password = {
	User.bob = {		Method = "sha256"; # Fill out this section with the generated password.
	Admin = true;		Hash = "...";
	Pass.password = {		Salt = "...";
	Method = "sha256"; # Fill out this section with the generated password.
	Hash = "...";
	Salt = "...";
	};
	};		};
	};		};
Line 45:		Line 42:
	</syntaxhighlight>		</syntaxhighlight>

	~~See also~~ [https://wiki.znc.in/Connecting_to_ZNC Connecting] and [https://wiki.znc.in/Category:Clients Category:Clients] on the ZNC wiki.		Next, see [https://wiki.znc.in/Connecting_to_ZNC Connecting] and [https://wiki.znc.in/Category:Clients Category:Clients] on the ZNC wiki.

	==Networks==		=Networks=
			SASL authentication is not yet supported from <code>configuration.nix</code>. Either <code>/msg *sasl</code> <ref>See [https://wiki.znc.in/Sasl Sasl] on the ZNC wiki.</ref> or use NickServ instead as shown below.

	{{~~Expansion\|This section is empty~~.}}		<syntaxhighlight lang="nix">
			service.znc.config.User.bob = {
			Network.freenode = { # The nickserv module will
			Server = "chat.freenode.net +6697 yourpassword"; # <- pick up your password here.
			Chan = { "#nixos" = {}; "#nixos-wiki" = {}; };
			Nick = "bob";
			LoadModule = [ "nickserv" ];
			JoinDelay = 2; # Avoid joining channels before authenticating.
			};
			};
			</syntaxhighlight>

imported>Mth at 21:41, 11 April 2019

2019-04-11T21:41:54Z

← Older revision		Revision as of 21:41, 11 April 2019
Line 8:		Line 8:
	enable = true;		enable = true;
	mutable = false; # Overwrite configuration set by ZNC from the web and chat interfaces.		mutable = false; # Overwrite configuration set by ZNC from the web and chat interfaces.
	useLegacyConfig = false; # ~~Use services.znc.config instead of~~ services.znc.confOptions.		useLegacyConfig = false; # Turn off services.znc.confOptions and their defaults.
	};		};
	</syntaxhighlight>		</syntaxhighlight>

imported>Mth at 21:11, 11 April 2019

2019-04-11T21:11:53Z

← Older revision		Revision as of 21:11, 11 April 2019
Line 1:		Line 1:
	~~=ZNC=~~

	[https://znc.in/ ZNC] is an [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] bouncer: it stays connected to IRC networks so clients can disconnect without missing messages or losing the session.		[https://znc.in/ ZNC] is an [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] bouncer: it stays connected to IRC networks so clients can disconnect without missing messages or losing the session.

imported>Mth: Created page with "=ZNC= [https://znc.in/ ZNC] is an [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] bouncer: it stays connected to IRC networks so clients can disconnect without missin..."

2019-04-11T21:10:37Z

Created page with "=ZNC= [https://znc.in/ ZNC] is an [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] bouncer: it stays connected to IRC networks so clients can disconnect without missin..."

New page

=ZNC=

[https://znc.in/ ZNC] is an [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC] bouncer: it stays connected to IRC networks so clients can disconnect without missing messages or losing the session.

{{Note|This page concerns NixOS 19.03 and later.}}

Start with the following:
<syntaxhighlight lang="nix">
services.znc = {
enable = true;
mutable = false; # Overwrite configuration set by ZNC from the web and chat interfaces.
useLegacyConfig = false; # Use services.znc.config instead of services.znc.confOptions.
};
</syntaxhighlight>

And use <code>services.znc.config</code> to configure ZNC as described in [https://wiki.znc.in/Configuration Configuration] on the ZNC wiki.

==Clients==

Generate a password with:
<syntaxhighlight lang="bash">
$ nix-shell --packages znc --command "znc --makepass"
</syntaxhighlight>

Then, in <code>configuration.nix</code>:
<syntaxhighlight lang="nix">
services.znc = {
# ...
openFirewall = true;
config = {
LoadModule = [ "adminlog" ]; # Write logs to ~znc/moddata/adminlog/znc.log.
User.bob = {
Admin = true;
Pass.password = {
Method = "sha256"; # Fill out this section with the generated password.
Hash = "...";
Salt = "...";
};
};
};
};
</syntaxhighlight>

SSL is enabled by default and a self-signed certificate is generated to <code>~znc/znc.pem</code>. A fingerprint can be extracted with:
<syntaxhighlight lang="bash">
cat ~znc/znc.pem | openssl x509 -sha512 -fingerprint -noout | tr -d ':' | tr 'A-Z' 'a-z' | cut -d = -f 2
</syntaxhighlight>

See also [https://wiki.znc.in/Connecting_to_ZNC Connecting] and [https://wiki.znc.in/Category:Clients Category:Clients] on the ZNC wiki.

==Networks==

{{Expansion|This section is empty.}}