sambee/config.example.toml at main · helgeklein/sambee · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
# Sambee Configuration File (Optional)
# All security secrets are auto-generated and stored in the database.
# This file is only needed for customizing application behavior.
#
# Copy this file to config.toml to customize settings:
#   cp config.example.toml config.toml

[app]
# Backend log level: DEBUG, INFO, WARNING, ERROR (case-insensitive)
log_level = "INFO"

[security]
# Authentication method: "password" or "none"
# - password: Standard username/password authentication (default)
# - none: No authentication required (use only if reverse proxy handles authentication)
auth_method = "password"

# JWT token expiration time in minutes (default: 24 hours)
access_token_expire_minutes = 1440

[admin]
# Initial admin account username
username = "admin"

[image_viewer]
# Conversion size threshold: images larger than this are always converted for viewing
# conv_size_thresh = 512000

[frontend_logging]
# Browser console logging (for development/debugging)
# Enable frontend logging to browser console (default: false in production builds, true in development builds)
# logging_enabled = false

# Console log level: DEBUG, INFO, WARNING, ERROR (case-insensitive)
# log_level = "WARNING"

# Backend tracing (for production monitoring and debugging)
# Enable frontend tracing to backend (default: false)
# tracing_enabled = false

# Delete frontend trace logs older than this many hours (default: 1)
# tracing_retention_hours = 1

# Tracing log level: DEBUG, INFO, WARNING, ERROR (case-insensitive)
# tracing_level = "ERROR"

# Trace components (comma-separated, empty = all components)
# Available components:
#   - api: API calls, authentication, HTTP requests/responses
#   - app: Application-level errors (ErrorBoundary)
#   - auth: Authentication configuration and login flows
#   - browser: File browser navigation, connections, directory loading
#   - browser-perf: Performance profiling metrics
#   - config: Configuration loading and management
#   - image-cache: Image caching, preloading, and gallery optimization
#   - viewer: File viewing and viewer component loading
#   - websocket: WebSocket connections and real-time updates
# tracing_components = ""

# Username regex filter - only trace for users matching this regex (default: empty = all users)
# Examples:
#   tracing_username_regex = "^admin$"           # Only admin user
#   tracing_username_regex = "^(admin|developer)$"  # admin or developer
#   tracing_username_regex = "^test"             # Any username starting with "test"
#   tracing_username_regex = ""                  # All users (when tracing_enabled = true)
# tracing_username_regex = ""

[directory_cache]
# Directory cache persistence settings for instant directory navigation.
# The cache stores an index of all directories on each SMB share so that
# search results are available immediately when the backend restarts.

# Location on disk (relative to data directory, or absolute path).
# Default: "directory_cache" (i.e. data/directory_cache/)
# location = "directory_cache"

# Minimum seconds between disk writes (coalesces rapid changes).
# coalesce_interval_seconds = 30

# Ignore cached snapshots older than this many minutes (default: 43200 = 30 days).
# max_staleness_minutes = 43200

[smb]
# SMB read chunk size in bytes. Larger chunks improve throughput but use more memory.
# read_chunk_size_bytes = 4194304

[preprocessors.imagemagick]
# Largest file ImageMagick will preprocess, in bytes.
# max_file_size_bytes = 104857600

# Maximum time allowed for ImageMagick conversions, in seconds.
# timeout_seconds = 30

[companion_downloads]
# Backend-managed Companion installer metadata.
# Sambee resolves Companion download links from this feed unless a pin override
# is configured below.
# metadata_feed_url = "https://release-feeds.sambee.net/feeds/sambee/companion/latest.json"

[companion_downloads.pin]
# Optional deterministic override for environments that must not follow the
# promoted latest feed automatically.
#
# When enabled, define a version plus at least one fully resolved asset URL.
# Sambee will expose these URLs directly to the frontend and will not fetch the
# promoted feed.
# version = "0.5.0"
# published_at = "2026-03-27T12:00:00Z"
# notes = "Pinned for validation"
# windows_x64_url = "https://downloads.example.test/Sambee-Companion_0.5.0_windows_x64-setup.exe"
# windows_arm64_url = "https://downloads.example.test/Sambee-Companion_0.5.0_windows_arm64-setup.exe"
# macos_arm64_url = "https://downloads.example.test/Sambee-Companion_0.5.0_macos_arm64.dmg"
# linux_x64_url = "https://downloads.example.test/Sambee-Companion_0.5.0_linux_x64.AppImage"