Overview

The top-level server: block controls the HTTP listener — the JSON API, the bundled web UI, authentication, permissions, and runtime limits.

Options

Option	Type	Required	Default	Description
`enabled`	bool	No	`true`	Turn the HTTP listener off to run snapr as a scheduler-only daemon.
`address`	string	No	`0.0.0.0:8080`	Listen address (`host:port`).
`secret`	string	No	—	JWT signing secret. Use `env:` in production.
`defaultLanguage`	`en` \| `ru`	No	`en`	Default UI language.
`auth`	object	No	—	Login flow for the UI and API. See Authentication.
`logLimits`	object	No	—	Initial tail size for the log viewers. See Log limits.
`permissions`	object	No	—	What authenticated users can do in the UI. See Permissions.
`ui`	object	No	—	Toggle the bundled web UI. See UI.

Setting server.enabled: false together with server.ui.enabled: true is rejected at startup — the UI cannot be served without a listener.

Sub-pages

Authentication

JWT-based login for the web UI and API endpoints.

Permissions

Control downloads, manual runs, and config visibility in the UI.

UI

Serve or disable the bundled web UI for API-only mode.

Log limits

Size the initial tail the log viewers request from the API.

Scheduler-only mode

Set server.enabled: false to drop the HTTP listener entirely. Jobs still run on their cron schedules and write logs to the host. This is useful for:

Minimal sidecars in a controlled environment.
Machines where the listener would be unreachable anyway.
Locking out manual runs and downloads at the binary level.

snapr.yaml

server:
  enabled: false

jobs:
  - name: nightly
    schedule: '0 2 * * *'
    # ...

Example

snapr.yaml

server:
  enabled: true
  address: '0.0.0.0:8080'
  secret: env:SNAPR_JWT_SECRET
  defaultLanguage: en
  auth:
    enabled: true
    username: admin
    password: env:SNAPR_ADMIN_PASSWORD
    tokenExpiration: 60
  permissions:
    allowBackupDownload: true
    allowManualRun: true
    showConfig: true
  ui:
    enabled: true

Getting started

Configuration

Options

Sub-pages

Authentication

Permissions

UI

Log limits

Scheduler-only mode

Example

​Options

​Sub-pages

Authentication

Permissions

UI

Log limits

​Scheduler-only mode

​Example

Options

Sub-pages

Scheduler-only mode

Example