Smos Logo Smos

A comprehensive self-management system

Home Manager Module Reference

Generated reference documentation about the home manager module for smos server deployments.

Options

programs.smos.backup

Periodic local backups of the workflow directory

Type: null or (submodule)

Default: null


programs.smos.backup.OnCalendar

How frequently to run the local backup

Type: string

Default: "daily"

Example: "weekly"


programs.smos.backup.backupDir

The directory to backup to

Type: string

Default: "/home/user/.local/share/smos/backup"


programs.smos.backup.enable

Whether to enable Smos backups.

Type: boolean

Default: false

Example: true


programs.smos.calendar

Periodic calendar imports

Type: null or (submodule)

Default: null


programs.smos.calendar.OnCalendar

How frequently to run the calendar import

Type: string

Default: "hourly"

Example: "daily"


programs.smos.calendar.enable

Whether to enable Smos calendar importing.

Type: boolean

Default: false

Example: true


programs.smos.calendar.sources

The list of sources to import from

Type: list of (submodule)

Default: [ ]


programs.smos.calendar.sources.*.destination

The destination file within the workflow directory

Type: string

Default: null

Example: "calendar/name.smos"


programs.smos.calendar.sources.*.name

The name of the source

Type: null or string

Default: null

Example: "Personal"


programs.smos.calendar.sources.*.source

The url to download the calendar from

Type: null or string

Default: null

Example: "https://calendar.google.com/calendar/ical/xxx.xxxxxxxxx%40gmail.com/private-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/basic.ics"


programs.smos.calendar.sources.*.source-file

The file containing the url to download the calendar from

Type: null or string

Default: null


programs.smos.config

The contents of the config file, as an attribute set. This will be translated to Yaml and put in the right place along with the rest of the options defined in this submodule.

Type: attribute set

Default: { }


programs.smos.enable

Whether to enable Smos.

Type: boolean

Default: false

Example: true


programs.smos.github

Desktop notifications

Type: null or (submodule)

Default: null


programs.smos.github.enable

Whether to enable Smos github activation.

Type: boolean

Default: false

Example: true


programs.smos.github.oauth-token

The oauth-token to use when talking to github

Type: null or string

Default: null


programs.smos.github.oauth-token-file

The oauth-token file to use when talking to github

Type: null or string

Default: null


programs.smos.notify

Desktop notifications

Type: null or (submodule)

Default: null


programs.smos.notify.OnCalendar

How frequently to run the notifier

Type: string

Default: "minutely"

Example: "*:0/2"


programs.smos.notify.enable

Whether to enable Smos notification activation.

Type: boolean

Default: false

Example: true


programs.smos.notify.notify-send

The package containing notify-send

Type: package

Default: <derivation libnotify-0.8.3>


programs.smos.scheduler

Automatic scheduled project scheduling

Type: null or (submodule)

Default: null


programs.smos.scheduler.OnCalendar

How frequently to run the scheduler

Type: string

Default: "hourly"

Example: "daily"


programs.smos.scheduler.enable

Whether to enable Smos scheduler activation.

Type: boolean

Default: false

Example: true


programs.smos.scheduler.schedule

The schedule to activate

Type: list of (submodule)

Default: [ ]


programs.smos.scheduler.schedule.*.description

A description of the schedule item. This is only used for logging and error messages.

Type: null or string

Default: null

Example: "Weekly tasks for work"


programs.smos.scheduler.schedule.*.destination

The template relative path to the destination in the workflow dir

Type: string

Default: null

Example: "workflow/work-[ %Y-%V | monday ].smos"


programs.smos.scheduler.schedule.*.schedule

The cron schedule for when to activate this item

Type: string

Default: null

Example: "0 12 * * 6"


programs.smos.scheduler.schedule.*.template

The relative path to the template in the workflow dir

Type: null or string or path

Default: null

Example: "templates/weekly.smos"


programs.smos.smosReleasePackages

The smosPackages attribute defined in the nix/overlay.nix file in the smos repository.

Type: attribute set

Default: { smos = <derivation smos-0.9.0>; smos-api = <derivation smos-api-0.7.0>; smos-api-gen = <derivation smos-api-gen-0.3.2>; smos-archive = <derivation smos-archive-0.5.0>; smos-calendar-import = <derivation smos-calendar-import-0.9.0>; smos-cli = <derivation smos-cli-0.1.0>; smos-client = <derivation smos-client-0.6.0>; smos-cursor = <derivation smos-cursor-0.7.0>; smos-cursor-gen = <derivation smos-cursor-gen-0.2.2>; smos-data = <derivation smos-data-0.6.2>; smos-data-gen = <derivation smos-data-gen-0.5.0>; smos-directory = <derivation smos-directory-0.1.0>; smos-directory-gen = <derivation smos-directory-gen-0.1.0>; smos-docs-site = <derivation smos-docs-site-0.0.0>; smos-e2e = <derivation smos-e2e-0.8.2>; smos-github = <derivation smos-github-0.7.0>; smos-jobhunt = <derivation smos-jobhunt-0.1.0>; smos-notify = <derivation smos-notify-0.4.0>; smos-query = <derivation smos-query-0.11.0>; smos-report = <derivation smos-report-0.11.0>; smos-report-cursor = <derivation smos-report-cursor-0.6.0>; smos-report-cursor-gen = <derivation smos-report-cursor-gen-0.4.0>; smos-report-gen = <derivation smos-report-gen-0.7.0>; smos-scheduler = <derivation smos-scheduler-0.8.0>; smos-server = <derivation smos-server-0.12.1>; smos-server-gen = <derivation smos-server-gen-0.8.0>; smos-single = <derivation smos-single-0.3.0>; smos-stripe-client = <derivation smos-stripe-client-0.1.0.0>; smos-sync-client = <derivation smos-sync-client-0.6.0>; smos-sync-client-gen = <derivation smos-sync-client-gen-0.4.1>; smos-web-server = <derivation smos-web-server-0.13.0>; smos-web-style = <derivation smos-web-style-0.0.2>; }


programs.smos.sync

Periodic local backups of the workflow directory

Type: null or (submodule)

Default: null


programs.smos.sync.OnCalendar

How frequently to run the synchronisation

Type: string

Default: "hourly"

Example: "daily"


programs.smos.sync.enable

Whether to enable Smos syncing.

Type: boolean

Default: false

Example: true


programs.smos.sync.password

The password to use when logging into the sync server

Type: null or string

Default: null

Example: "hunter12"


programs.smos.sync.password-file

The password file to use when logging into the sync server

Type: null or string

Default: null


programs.smos.sync.server-url

The url of the sync server

Type: string

Example: "api.smos.cs-syd.eu"


programs.smos.sync.username

The username to use when logging into the sync server

Type: string

Example: "syd"


programs.smos.workflowDir

Smos' workflow directory

Type: string

Default: "/home/user/workflow"