Це повний індекс кожного persistent-налаштування, яке експортує BamDude — що робить, дефолт, де в UI. Налаштування живуть у key-value таблиці settings; більшість виставлені під Settings у бічному меню, але кілька — read-only mirror'и env-змінних (env виграє).
Джерело істини — backend/app/schemas/settings.py::AppSettings. Якщо налаштування немає тут, перевіряйте там, перш ніж вважати, що його не існує — дефолти нижче звірені з кодом.
Серверний default-язик для всіх браузерів + Telegram-чатів + email-шаблонів. Frontend читає це на першому завантаженні і синкить i18n; юзери можуть перевизначати per-tab у UI.
time_format
system
system (browser locale), 12h або 24h. ETA / timestamps у картках, нотифікаціях, листах.
date_format
system
system (browser locale), us (MM/DD/YYYY), eu (DD/MM/YYYY), iso (YYYY-MM-DD). Контролює кожну видиму дату.
currency
USD
Код валюти для відображення вартості.
external_url
пусто
Публічний URL BamDude. Виграє над env-змінною APP_URL. Використовується в password-reset / MFA email-посиланнях, OIDC callback construction і Obico cached-frame URL. Постав, коли BamDude за reverse proxy.
default_printer_id
не задано
Default-принтер для нових queue-items / Print Now з file-manager.
Дозволити auto-drying між queue-items, коли пластик наступного друку це потребує.
queue_drying_block
false
Блокувати наступний друк до завершення drying (замість паралельно з поточним).
ambient_drying_enabled
false
Auto-сушити AMS-філамент на idle-принтерах, коли humidity вище порогу — незалежно від стану черги.
print_drying_enabled
false
Дозволити auto-drying стріляти й на принтері, який зараз друкує, коли його модель + firmware підтримують concurrent drying (H2D 01.03.00.00+, H2C/H2S/P2S/H2D Pro 01.02.00.00+, X2D/A2L 01.01.00.00+, X1C 01.11.02.00+). Температура сушіння під час друку капається на 5 °C нижче idle-пресету (floor 40 °C). Див. AMS та вологість.
Головний перемикач серверного слайсингу. Вимкнено — кнопку Slice замінює «відкрити у своєму десктопному слайсері».
orcaslicer_api_url
порожньо
URL sidecar'а OrcaSlicer. Порожнє падає на env-змінну SLICER_API_URL (http://localhost:3003). Перевіряється при збереженні — див. нижче.
bambu_studio_api_url
порожньо
URL sidecar'а BambuStudio. Порожнє падає на BAMBU_STUDIO_API_URL (http://localhost:3001). Перевіряється при збереженні.
slicer_stall_timeout_minutes
15
Хвилин чекати без жодного прогресу від sidecar'а (діапазон 1–240). Годинник скидається на кожному оновленні прогресу, тож важка модель, яка звітує, дорізається до кінця. На sidecar'і, надто старому, щоб звітувати про прогрес, це обмежує загальний час нарізки.
Адреси, які ти вводиш, перевіряються
Обидва URL слайсерів, URL Home Assistant і ендпоінт детекції Obico перевіряються
перед збереженням. Помилкове чи вороже значення могло б спрямувати BamDude туди,
куди він ніколи не має ходити, — насамперед на адресу метаданих хмари, а це
стандартний спосіб вичитати креденшели із сервера.
Адреси у власній машині чи домашній мережі лишаються дозволеними, бо саме там ці
сервіси зазвичай і живуть. Відхиляється: не-веб адреса, адреса, записана простим
числом, мультикастова адреса й ендпоінти метаданих хмари. Адреса issuer'а
єдиного входу, яка має бути досяжною з публічного інтернету, перевіряється
суворішим правилом, яким і мала перевірятися завжди.
% залишку котушки, при якому стріляє filament_low. Діапазон 0.1 – 99.9.
runout_zero_point_enabled
true
Закривати котушку рівно на вазі етикетки, коли принтер однозначно повідомляє про runout.
ams_sync_bidirectional
true
Дозволити показанням AMS на простої коригувати вагу Bambu-тегованої котушки і вниз (значення має повторитися у двох звітах з інтервалом у хвилину).
runout_purge_grams
0
Грами на резервну котушку за продувку при автоперемиканні AMS. 0 — вимкнено.
usage_events_retention_hours
72
Скільки годин тримати журнал usage-подій завершеного друку (таймлайн runout/лотків) для розбору.
disable_filament_warnings
false
Master mute для low / out-of-filament алертів.
prefer_lowest_filament
true
Після сумісності й переваги точного кольору авто-призначення віддає перевагу джерелу з найменшим залишком. Відстежувані AMS-котушки використовують грами, джерела лише з прошивкою — відсоток в окремому рівні.
default_filament_cost
25.0
Per-kg fallback-ціна, коли поле cost котушки не задано.
auto_add_unknown_rfid
true
Авто-додавати котушку в інвентар, коли AMS читає невідомий RFID-тег. Off → замість тихого створення показується картка підтвердження (матеріал / колір префілені). Див. Інвентар котушок.
ams_humidity_good
40
Зелена-зона humidity-поріг (%) на AMS-картках (≤ це значення).
ams_humidity_fair
60
Жовта-зона humidity (≤ це значення). Вище — червоне.
ams_humidity_thresholds
пусто
JSON-мапа per-filament-type порогів вологості для auto-drying + алармів — {"default": int, "PLA": int, "ASA": int, …}. Пусто = fallback на ams_humidity_fair для всіх типів. Multi-material AMS резолвиться до найсуворішого (найнижчого) серед завантажених котушок.
ams_temp_good
28.0
Зелена-зона temp-поріг (°C) на AMS-картках.
ams_temp_fair
35.0
Жовта-зона temp. Вище — червоне.
ams_history_retention_days
30
Скільки днів історії AMS тримати до prune.
inbox_retention_days
30
Скільки днів історії центру сповіщень зберігається в кожного користувача. Діапазон 1-365. Прибирається раз на добу, незалежно від прочитаності.
log_retention_days
7
Ліміт зберігання добових архівів bamdude-YYYY-MM-DD.log. Діапазон 1–365. Зайві архіви видаляються під час наступної успішної ротації. Див. System info → Ротація логів.
bed_cooled_threshold
35.0
Температура столу (°C), при якій стріляє нотифікація bed_cooled.
Увімкнути MQTT publishing — републікувати стан принтерів у зовнішній MQTT-брокер.
mqtt_broker
пусто
Hostname або IP брокера.
mqtt_port
1883
Порт брокера. TLS-деплої зазвичай використовують 8883.
mqtt_username / mqtt_password
пусто
Auth брокера. Пароль шифрується at-rest.
mqtt_use_tls
false
TLS для з'єднання з MQTT-брокером.
mqtt_topic_prefix
bambuddy
Prefix для всіх республікованих топіків. Успадковано з апстрім Bambuddy — змініть на bamdude на свіжих інсталяціях, якщо так зручніше.
ftp_retry_enabled
true
Перевикачувати FTP 3MF, коли принтер був недосяжний на старті. Див. Print Archive.
ftp_retry_count
3
Максимум retry на цикл (1–10).
ftp_retry_delay
2
Секунди між retry (1–30).
ftp_timeout
30
Скільки секунд одна FTP-операція може простояти без даних (10–300). Обмежує застряглу передачу, а не повільну -- завантаженню 3MF, яке продовжує йти, дадуть докачатись, скільки б воно не тривало. Див. Архів друку.
Коли true, невідомі Telegram-чати авто-реєструються з is_active=False, group_id=NULL (pending admin activation). Коли false, невідомі чати відхиляються одразу. Окремого "approval"-режиму немає — auto-register-then-activate flow робить саме true.
user_notifications_enabled
true
Увімкнути per-user email-нотифікації для друків, які користувач власник (потрібен Advanced Authentication).
Каденс опитування Zigbee-датчиків від мережі (з джитером, як у полера розеток). Батарейні датчики не опитуються ніколи — вони сплять.
zigbee_sensor_reporting
пусто
JSON per-measurement дефолтів звітування ({"temperature": {"min_interval": …, "max_interval": …, "reportable_change": …}, …}) для пристроїв без власного override. Пусто чи відсутнє поле = дефолти реєстру.
zigbee_sensor_stale_multiplier
2
Показ reporting-датчика, старший за це кратне його max_interval, вважається застарілим («датчик замовк»). Per-device override виграє; полюваних пристроїв не стосується (фіксовані 120 с).
Кілька auth-налаштувань редагуються з UI (Settings → Users):
Key
Default
Ефект
session_max_hours
720
Адмін-стеля на час життя сесії (TTL refresh-токена), у годинах. Діапазон 1–720; дефолт 720 год (30 днів) зберігає remember-me. Застосовується до існуючих сесій при їх наступному refresh. Виставляється через картку Session Policy. Див. Автентифікація.
local_login_enabled
true
Дозволити логін username + password на /auth/login. Вимкни, коли має бути придатний лише SSO (guarded: потрібен ≥ 1 увімкнений OIDC-провайдер і твій власний акаунт, злінкований з OIDC). Env BAMDUDE_LOCAL_LOGIN=true обходить це на рівні route для recovery.
Решта — read-only mirror'и env-змінних; задавай їх через змінні середовища. Деталі env — на сторінці інсталяції.
Setting
Source
Ефект
Setup gate active
таблиця users
Опускається автоматом, коли створений перший адмін. CLI reset_admin чистить його для recovery.
JWT signing key
env JWT_SECRET_KEY або файл data/.jwt_secret
Auto-generated на першому boot, якщо нічого з цього нема.
Refresh-cookie Secure flag
env AUTH_REFRESH_COOKIE_SECURE
Auto-detect зі схеми запиту, коли не задано.
Trusted reverse-proxy IPs
env TRUSTED_PROXY_IPS
Comma-separated. Потрібно для коректного per-IP rate-limit за nginx / Caddy.
MFA-secret encryption key
env MFA_ENCRYPTION_KEY
Plaintext fallback працює без нього, але логує warning.