Uninterruptible power supply - Revision history

Starfish2228: /* Delay UPS Shutdown */ remove redundant section, as similar code is already present in NixOS

2026-04-30T06:01:34Z

Delay UPS Shutdown: remove redundant section, as similar code is already present in NixOS

@@ Line 205: / Line 205: @@
     };
 </syntaxhighlight>
 [[Category:Hardware]]

Robotron2084: Added a comment to explain what the contents of passwordFile should contain. Paths to internal nix resources will throw an error, modified passwordFile to be to an absolute path instead.

2026-02-15T16:09:30Z

Added a comment to explain what the contents of passwordFile should contain. Paths to internal nix resources will throw an error, modified passwordFile to be to an absolute path instead.

← Older revision		Revision as of 16:09, 15 February 2026
Line 132:		Line 132:
	# declarations. upsd.users		# declarations. upsd.users
	users."nut-admin" = {		users."nut-admin" = {
	passwordFile = "~~${..~~/~~resources~~/ups-passwd.txt}";		# A file that contains just the password.
			passwordFile = "/etc/nixos/ups-passwd.txt";
	upsmon = "primary";		upsmon = "primary";
	};		};
Line 147:		Line 148:
	powerValue = 1;		powerValue = 1;
	user = "nut-admin";		user = "nut-admin";
	passwordFile = "~~${..~~/~~resources~~/ups-passwd.txt}";		passwordFile = "/etc/nixos/ups-passwd.txt";
	type = "primary";		type = "primary";
	};		};

Wo2wz: remove unnecessary portion under compatible hardware

2026-01-01T01:18:23Z

remove unnecessary portion under compatible hardware

← Older revision		Revision as of 01:18, 1 January 2026
Line 25:		Line 25:
	needs a new battery every four years, under optimal operating		needs a new battery every four years, under optimal operating
	conditions.		conditions.

	~~The end of ConfigExample book says:~~

	~~Joe's server will still be allright~~
	~~if power drops off in the night.~~
	~~That 8 year old pack~~
	~~of battery backup~~
	~~will easily handle th connection lost~~

	= Components of NUT Software =		= Components of NUT Software =

Klinger: Category:Hardware added

2025-12-29T13:21:31Z

Category:Hardware added

← Older revision		Revision as of 13:21, 29 December 2025
Line 265:		Line 265:
	};		};
	</syntaxhighlight>		</syntaxhighlight>


			[[Category:Hardware]]

Tie-ling: /* Delay UPS Shutdown */ do not use slice

2025-10-10T03:12:44Z

Delay UPS Shutdown: do not use slice

← Older revision		Revision as of 03:12, 10 October 2025
Line 246:		Line 246:
	# copied from ConfigExamples 3.0 book, Appendix B.2.		# copied from ConfigExamples 3.0 book, Appendix B.2.
	systemd.services.nut-delayed-ups-shutdown = {		systemd.services.nut-delayed-ups-shutdown = {
	environment = config.systemd.services.~~upsd~~.environment;		enable = true;
	~~unitConfig = {~~		environment = config.systemd.services.upsmon.environment;
	~~Description~~ = "Initiate delayed UPS shutdown";		description = "Initiate delayed UPS shutdown";
	~~Before~~ = "umount.target";		before = [ "umount.target" ];
	~~DefaultDependencies~~ = ~~false;~~		wantedBy = [ "final.target" ];
	};
	serviceConfig = {		serviceConfig = {
	Type = "oneshot";		Type = "oneshot";
	ExecStart = ''${pkgs.~~bash~~}/bin/~~bash~~ -c\		# need to use '-u root', or else permission denied
	"${~~pkgs~~.~~util-linux}/bin/logger -t\~~		ExecStart = ''${pkgs.nut}/bin/upsdrvctl -u root shutdown'';
	~~nut-delayed-~~ups~~-shutdown 'upsdrvctl shutting down UPS'~~;\		# must not use slice: if used, upsdrvctl will not run as a late
	~~${pkgs.nut}/bin/upsdrvctl shutdown~~"'';		# shutdown service
			# Slice = "";
			};
			unitConfig = {
			ConditionPathExists = config.power.ups.upsmon.settings.POWERDOWNFLAG;
			DefaultDependencies = "no";
	};		};
	~~wantedBy = [ "final.target" ];~~
	};		};
	</syntaxhighlight>		</syntaxhighlight>

Tie-ling: /* Delay UPS Shutdown */ fix attrset

2025-10-10T00:11:06Z

Delay UPS Shutdown: fix attrset

← Older revision		Revision as of 00:11, 10 October 2025
Line 246:		Line 246:
	# copied from ConfigExamples 3.0 book, Appendix B.2.		# copied from ConfigExamples 3.0 book, Appendix B.2.
	systemd.services.nut-delayed-ups-shutdown = {		systemd.services.nut-delayed-ups-shutdown = {
	environment = config.systemd.services.upsd~~.service~~.environment;		environment = config.systemd.services.upsd.environment;
	unitConfig = {		unitConfig = {
	Description = "Initiate delayed UPS shutdown";		Description = "Initiate delayed UPS shutdown";

Tie-ling: /* Delay UPS Shutdown */ use shortcut

2025-10-10T00:08:32Z

Delay UPS Shutdown: use shortcut

← Older revision		Revision as of 00:08, 10 October 2025
Line 246:		Line 246:
	# copied from ConfigExamples 3.0 book, Appendix B.2.		# copied from ConfigExamples 3.0 book, Appendix B.2.
	systemd.services.nut-delayed-ups-shutdown = {		systemd.services.nut-delayed-ups-shutdown = {
	environment = {		environment = config.systemd.services.upsd.service.environment;
	~~# taken from output of $(systemctl cat~~ upsd.service)
	~~NUT_CONFPATH = "/etc/nut";~~
	~~NUT_STATEPATH = "/var/lib/nut";~~
	};
	unitConfig = {		unitConfig = {
	Description = "Initiate delayed UPS shutdown";		Description = "Initiate delayed UPS shutdown";

Tie-ling: /* Delay UPS Shutdown */ use nut statepath

2025-10-10T00:07:31Z

Delay UPS Shutdown: use nut statepath

← Older revision		Revision as of 00:07, 10 October 2025
Line 247:		Line 247:
	systemd.services.nut-delayed-ups-shutdown = {		systemd.services.nut-delayed-ups-shutdown = {
	environment = {		environment = {
			# taken from output of $(systemctl cat upsd.service)
	NUT_CONFPATH = "/etc/nut";		NUT_CONFPATH = "/etc/nut";
			NUT_STATEPATH = "/var/lib/nut";
	};		};
	unitConfig = {		unitConfig = {

Tie-ling: environment var

2025-10-09T23:54:24Z

environment var

← Older revision		Revision as of 23:54, 9 October 2025
Line 102:		Line 102:
	# upsmon initiate shutdown once this threshold is reached.		# upsmon initiate shutdown once this threshold is reached.
	"lowbatt = 40"		"lowbatt = 40"

			# ignore it if the UPS reports a low battery condition
			# without this, system will shutdown only when ups reports lb,
			# not respecting lowbatt option
			"ignorelb"
	];		];
	};		};
Line 241:		Line 246:
	# copied from ConfigExamples 3.0 book, Appendix B.2.		# copied from ConfigExamples 3.0 book, Appendix B.2.
	systemd.services.nut-delayed-ups-shutdown = {		systemd.services.nut-delayed-ups-shutdown = {
			environment = {
			NUT_CONFPATH = "/etc/nut";
			};
	unitConfig = {		unitConfig = {
	Description = "Initiate delayed UPS shutdown";		Description = "Initiate delayed UPS shutdown";

Tie-ling: /* Delay UPS Shutdown */ fix formatting

2025-10-07T02:04:57Z

Delay UPS Shutdown: fix formatting

← Older revision		Revision as of 02:04, 7 October 2025
Line 220:		Line 220:

	During the system shutdown, systemd service unit runs the command		During the system shutdown, systemd service unit runs the command
	upsdrvctl shutdown. This tells the UPS that it is to shut down		<code>upsdrvctl shutdown</code>. This tells the UPS that it is to shut down
	offdelay seconds later. The system powers down before offdelay seconds		offdelay seconds later. The system powers down before offdelay seconds
	have passed. Wall power returns before the UPS shuts down Less than		have passed. Wall power returns before the UPS shuts down. Less than
	offdelay seconds have passed. The UPS continues it's shutdown		offdelay seconds have now passed. The UPS continues it's shutdown
	process.		process.

	After offdelay seconds the UPS shuts down, disconnecting it's		After offdelay seconds the UPS shuts down, disconnecting it's
	outlets. The beeping stops. With some UPS units, there is an audible		outlets. The beeping stops. With some UPS units, there is an audible
	clunk. An interval of ondelay-offdelay seconds later: After ondelay		clunk. An interval of ondelay minus offdelay seconds later: After ondelay
	seconds the UPS turns itself on, and repowers it's outlets. The system		seconds the UPS turns itself on, and repowers it's outlets. The system
	BIOS option Restore Power on AC return has hopefully been selected and		BIOS option Restore Power on AC return has hopefully been selected and