Omnom

Omnom is a webpage bookmarking and snapshotting service.

This project is funded by NLnet through these subgrants:

Options

services.omnom.dataDir

The directory where Omnom stores its data files.

Type:
absolute path
Default:
"/var/lib/omnom"
services.omnom.enable

Whether to enable Omnom, a webpage bookmarking and snapshotting service.

Type:
boolean
Default:
false
services.omnom.group

The Omnom service group.

Type:
non-empty string
Default:
"omnom"
services.omnom.openFirewall

Whether to open ports in the firewall.

Type:
boolean
Default:
false
services.omnom.package

The omnom package to use.

Type:
package
Default:
pkgs.omnom
services.omnom.passwordFile

File containing the password for the SMTP user.

Type:
null or absolute path
Default:
null
services.omnom.port

The Omnom service port.

Type:
16 bit unsigned integer; between 0 and 65535 (both inclusive)
Default:
7331
services.omnom.settings

Configuration options for the /etc/omnom/config.yml file.

Type:
YAML value
Default:
{ }
services.omnom.settings.app.debug

Whether to enable debug mode.

Type:
boolean
Default:
false
services.omnom.settings.app.disable_signup

Whether to enable restricting user creation.

Type:
boolean
Default:
false
services.omnom.settings.app.results_per_page

Number of results per page.

Type:
signed integer
Default:
20
services.omnom.settings.db.connection

Database connection URI.

Type:
string
Default:
"${config.services.omnom.dataDir}/db.sqlite3"
services.omnom.settings.db.type

Database type.

Type:
value "sqlite" (singular enum)
Default:
"sqlite"
services.omnom.settings.server.address

Server address.

Type:
string
Default:
"127.0.0.1:${config.services.omnom.port}"
services.omnom.settings.server.secure_cookie

Whether to limit cookies to a secure channel.

Type:
boolean
Default:
true
services.omnom.settings.smtp.connection_timeout

Connection timeout duration in seconds.

Type:
signed integer
Default:
5
services.omnom.settings.smtp.host

SMTP server hostname.

Type:
string
Default:
""
services.omnom.settings.smtp.port

SMTP server port address.

Type:
16 bit unsigned integer; between 0 and 65535 (both inclusive)
Default:
25
services.omnom.settings.smtp.send_timeout

Send timeout duration in seconds.

Type:
signed integer
Default:
10
services.omnom.settings.smtp.sender

Omnom sender e-mail.

Type:
string
Default:
"Omnom "
services.omnom.settings.smtp.tls

Whether to enable Whether TLS encryption should be used..

Type:
boolean
Default:
false
services.omnom.settings.smtp.tls_allow_insecure

Whether to enable Whether to allow insecure TLS..

Type:
boolean
Default:
false
services.omnom.settings.storage.root

Where the snapshots are saved.

Type:
absolute path
Default:
"${config.services.omnom.dataDir}/static/data"
services.omnom.settings.storage.type

Storage type.

Type:
string
Default:
"fs"
services.omnom.user

The Omnom service user.

Type:
non-empty string
Default:
"omnom"

Examples

  • Basic Omnom configuration, mainly used for testing purposes 
    { ... }:
{
  services.omnom = {
    enable = true;
    openFirewall = true;

    port = 8080;

    settings = {
      app = {
        disable_signup = true; # restrict CLI user-creation
        results_per_page = 50;
      };
      smtp = {
        tls = true;
        host = "127.0.0.1";
        port = 1025;
        username = "testUser";
      };
    };

    #Contains password for SMIP User
    passwordFile = "/etc/secrets/omnom.key";
  };
}