michael orlitzky


get it

The development version can be found in the untangle-https-backup git repository. The latest official release is untangle-https-backup-0.1.0.

What is it?

The Untangle web UI provides a way to create backups of the local configuration. However, if you manage enough Untangle installations, it becomes impractical to log in to each one and navigate to the backups in a browser. The untangle-https-backup program automates that process for a list of installations contained in a configuration file.

An example configuration file is provided.


user $ untangle-https-backup [--config-file <INI file>]


None; the program's behavior is entirely determined by its configuration (INI) file.


Errors are output to stderr; otherwise, silence is golden.

Configuration file

The configuration file is an INI-style list of Untangle installations to back up. An example entry is,

[Test installation]
host =
username = testuser
password = hunter2

There are currently five parameters that may be set for each installation:

host (required)
The hostname or IP address where the Untangle web UI is available.
(default: admin) The Untangle admin username.
password (required)
The Untangle admin password.
(default: 14.1) The version of Untangle running on this host. Versions 9, 10, 11, 12, 13, 13.1, 14, and 14.1 are supported.
(default: False) Whether or not to verify the site's SSL certificate, either True or False.
(default: 300) How long to wait for socket operations to complete, in seconds.


It is difficult to invoke untangle-https-backup incorrectly:

user $ untangle-https-backup

Show the usage information:

user $ untangle-https-backup --help

Specify an alternate configuration file:

user $ untangle-https-backup --config-file /etc/foo.ini


--config-file, -c
(default: /etc/untangle-https-backup.ini) Path to the configuration file.

How to report bugs

Email them to me at michael@orlitzky.com.