Табло с Appsmith над Postgres и Ollama
Правим на локален AI сървър от класа NVIDIA GB10 сутрешно табло за управителя: четири живи числа и два списъка от базата, и кратък брифинг, който пише локален модел. Всичко върви в Docker, моделът не напуска машината, а таблото вижда само това, което му разрешим.
llama3.1:70b (около 43 GB, а в Appsmith заявката чака по подразбиране само 10 секунди), стария формат /api/generate с prompt и сума „лв.“ (сега е /api/chat със съобщения, а сумите са в EUR), задължителния n8n в 7:00 (по-лесно е брифингът да се пуска от бутон; n8n остава по желание), камерите през друга услуга (в този урок са таблица devices), Telegram и твърдението, че Text уиджетът показва Markdown (не го проверихме). Добавихме: образ appsmith/appsmith-ce с версия v2.4.3 (има сборка за ARM64), лиценз Apache 2.0 за Community Edition, Postgres 18 и Ollama 0.35.0 закачени във .env, Ollama като вътрешна услуга без публикуван порт, отделна роля в базата само с нужните права, тайни, генерирани на място, измислени данни, JS обект с setInterval, срок на заявката 60 секунди, копия на базата и на Appsmith, SSH тунел. Всички данни в урока са измислени.
127.0.0.1:8080 вместо на порт 80 (документацията показва 80 и 443), SQL файлът с демонстрационните данни, имената на настройките в интерфейса на Appsmith и скоростта на модела. Страницата с версиите на GitHub не успяхме да прочетем, затова версията v2.4.3 е по етикета в Docker Hub.01Какво ще научиш
- Какво прави Appsmith и защо е удобен за вътрешно табло, без да пишеш уеб страница.
- Как да вдигнеш Appsmith, Postgres и Ollama в един Docker Compose проект.
- Как да дадеш на таблото отделна роля в базата с минимални права.
- Как да свържеш базата и да направиш четири числа, таблица и графика със SQL заявки.
- Как да извикаш локален модел през REST API на Ollama и да запишеш брифинга в базата.
- Как да направиш числата „живи“ и как да правиш копия на данните.
02Преди да започнеш
- Машина от класа NVIDIA GB10 (например ASUS Ascent GX10 или DGX Spark) с DGX OS (Ubuntu 24.04 за Arm64), настроена по първото включване.
- Достъп до терминала на машината — директно или по SSH.
- Docker и NVIDIA Container Toolkit — на DGX Spark са предварително инсталирани (по документацията на NVIDIA). Ако Docker иска
sudo, пиши го пред командите. - Интернет за изтеглянето на образите и моделите. Appsmith в документацията си иска изходящ достъп до
cs.appsmith.com. - Памет: Appsmith в готовия си образ носи в себе си MongoDB, Redis и PostgreSQL и по документацията иска поне 8 GB на хоста. На GB10 паметта е обща с видеокартата, затова остави място и за модела.
- Малко SQL — само
SELECTиINSERT.
| Какво | Стойност (проверено на 01.10.2026) |
|---|---|
| Appsmith Community Edition | образ appsmith/appsmith-ce, последна версия v2.4.3 (Docker Hub, 30.09.2026), има сборка linux/arm64 |
| Лиценз | Apache License 2.0 (файлът LICENSE в хранилището на Appsmith) |
| Postgres | образ postgres:18, има сборка linux/arm64 |
| Ollama | образ ollama/ollama:0.35.0, има сборка linux/arm64 |
appsmith-ee (Commercial edition с безплатен план) и казва, че за Community се сменя appsmith-ee с appsmith-ce. Тук ползваме Community Edition, защото кодът му е с лиценз Apache 2.0. ⚠️ Не сме сравнявали какво точно получаваш в безплатния план на Commercial — виж документацията, ако това ти е важно.03Стъпки
-
Какво ще стои къде
Накрая ще имаш три контейнера в един проект. Защо контейнери? Всяка програма идва с всичко нужно, не пречи на другите и се маха с една команда.
Услуга За какво е Достъп Appsmith Таблото — екрани, заявки, графики само 127.0.0.1:8080на машинатаPostgres Данните на таблото (измислени) вътрешна, без публикуван порт Ollama Локалният модел, който пише брифинга вътрешна, без публикуван порт Услугите се намират по име от compose файла: базата е
postgres, моделът еollama. Вътре в контейнерlocalhostе самият контейнер. -
Провери машината
bash · на машинатаuname -m docker --version docker compose versionОчакваш
aarch64и Compose v2. Ако си минал урока за n8n, Docker вече е проверен — стекът на таблото е отделен проект и може да върви до него. ⚠️ Не сме пробвали двата стека едновременно върху една машина. -
Папка и файл с тайните
Паролите не се пишат в compose файла. Държим ги в
.env— Compose го чете сам. Генерираме ги на място. Две различни пароли: на собственика на базата и на ролята, с която ще влиза таблото.bash · ~/dashboard-gx10/.envmkdir -p ~/dashboard-gx10 && cd ~/dashboard-gx10 cat > .env <<EOF APPSMITH_VERSION=v2.4.3 OLLAMA_VERSION=0.35.0 POSTGRES_USER=dash_owner POSTGRES_PASSWORD=$(openssl rand -hex 24) POSTGRES_DB=dashboard DASH_PASSWORD=$(openssl rand -hex 24) TZ=Europe/Sofia EOF chmod 600 .env✅Версиите са закачениНе пишиlatest: при следващо създаване на контейнера версията може тихо да се смени. Документацията на Appsmith също препоръчва закачен етикет. Числата са текущите към 01.10.2026 — виж „Обновяване“ по-долу. -
Файлът compose.yaml
Правилата са същите като в урока за n8n: версии закачени, данни в именувани томове, единственият публикуван порт е на Appsmith и то само към
127.0.0.1, а Appsmith чака Postgres да е „здрав“. Папката./stacksе мястото за данните на Appsmith — така я показва и документацията му.yaml · ~/dashboard-gx10/compose.yamlname: dashboard-gx10 services: postgres: image: postgres:18 restart: unless-stopped environment: POSTGRES_USER: ${POSTGRES_USER} POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} POSTGRES_DB: ${POSTGRES_DB} DASH_PASSWORD: ${DASH_PASSWORD} PGDATA: /var/lib/postgresql/data volumes: - db_data:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}"] interval: 5s timeout: 5s retries: 10 ollama: image: ollama/ollama:${OLLAMA_VERSION} restart: unless-stopped volumes: - ollama_models:/root/.ollama deploy: resources: reservations: devices: - driver: nvidia count: all capabilities: [gpu] appsmith: image: appsmith/appsmith-ce:${APPSMITH_VERSION} restart: unless-stopped depends_on: postgres: condition: service_healthy ports: - "127.0.0.1:8080:80" volumes: - ./stacks:/appsmith-stacks volumes: db_data: ollama_models:💡Защо точно такаPGDATA — Postgres 18 смени мястото на данните по подразбиране; без този ред базата започва празна. Ollama безports— моделът е достъпен само за другите контейнери в проекта, не за мрежата. 127.0.0.1:8080:80 — Appsmith слуша на порт 80 в контейнера; навън го показваме само на самата машина. Postgres със собствена база — таблото има своя, а не чужда база с важни данни.bashdocker compose config --quiet && echo "compose: OK" -
Стартирай стека
bashdocker compose up -d docker compose ps docker compose logs -f appsmith --tail=30Първия път се теглят образите. По документацията на Appsmith стартирането може да отнеме до 5 минути — гледай логовете, докато спрат да се сменят (изход с
Ctrl+C).postgresтрябва да еhealthy. -
Демонстрационни данни и роля с малко права
Правим четири таблици с измислени данни и роля
dash_app. Защо отделна роля? Ако някой открадне паролата на таблото или направи грешка в заявка, да не може да трие и променя таблиците. Ролята чете всичко и пише само вbriefings. Паролата ѝ идва от променлива, а не от файла.bash · ~/dashboard-gx10/init.sqlcat > init.sql <<'EOF' CREATE ROLE dash_app LOGIN PASSWORD :'pw'; CREATE TABLE tickets ( id serial PRIMARY KEY, title text NOT NULL, status text NOT NULL CHECK (status IN ('open','closed')), created_at timestamptz NOT NULL DEFAULT now() ); CREATE TABLE invoices ( id serial PRIMARY KEY, client text NOT NULL, amount_eur numeric(10,2) NOT NULL, status text NOT NULL CHECK (status IN ('pending','paid')), due_date date NOT NULL, paid_at timestamptz ); CREATE TABLE devices ( id serial PRIMARY KEY, name text NOT NULL, online boolean NOT NULL ); CREATE TABLE briefings ( id serial PRIMARY KEY, created_at timestamptz NOT NULL DEFAULT now(), model text NOT NULL, body text NOT NULL ); INSERT INTO tickets (title, status, created_at) VALUES ('Принтерът в склада не печата', 'open', now() - interval '3 hours'), ('Нов служител — достъп до пощата', 'open', now() - interval '20 hours'), ('Бавна мрежа в офиса', 'open', now() - interval '2 days'), ('Смяна на тонера', 'closed', now() - interval '4 days'); INSERT INTO invoices (client, amount_eur, status, due_date, paid_at) VALUES ('Клиент Алфа', 420.00, 'pending', current_date - 12, NULL), ('Клиент Бета', 150.50, 'pending', current_date - 3, NULL), ('Клиент Гама', 980.00, 'pending', current_date + 9, NULL), ('Клиент Делта', 310.00, 'paid', current_date - 5, now() - interval '1 hour'), ('Клиент Епсилон', 75.00, 'paid', current_date - 2, now() - interval '1 day'), ('Клиент Зета', 205.00, 'paid', current_date - 8, now() - interval '3 days'); INSERT INTO devices (name, online) VALUES ('Сензор вход', true), ('Сензор склад', true), ('Сензор двор', false), ('Сензор офис', true); GRANT SELECT ON tickets, invoices, devices, briefings TO dash_app; GRANT INSERT ON briefings TO dash_app; GRANT USAGE ON SEQUENCE briefings_id_seq TO dash_app; EOF docker compose exec -T postgres sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -v ON_ERROR_STOP=1 -v pw="$DASH_PASSWORD"' < init.sqlОчакваш редове
CREATE ROLE,CREATE TABLE,INSERTиGRANT, без грешки. Паролата се подава наpsqlкато променливаpwи затова във файла я няма. ⚠️ Този файл не сме го пускали на живо. -
Отвори Appsmith от своя компютър
Appsmith слуша само на самата машина. От твоя компютър стигаш до него през SSH тунел — защитен коридор, който не отваря нищо към мрежата.
bash · на твоя компютърssh -L 8080:localhost:8080 <потребител>@<адрес-на-машината>Остави връзката отворена и отвори
http://localhost:8080. При първо отваряне Appsmith те кара да създадеш администраторски акаунт. После предлага безплатен план или лицензен ключ — за този урок не ти трябва ключ. Ако работиш директно на машината, отвори същия адрес там.🌐Какво изпраща Appsmith навънПо страницата на Appsmith за телеметрия сървърът му пуска „keep-alive“ сигнал на всеки 2 часа, независимо от настройката за телеметрия, а данните от самоуправляваните инсталации са анонимизирани. Върнатите от твоите бази данни не се събират. Прочети страницата и реши сам какво да изключиш. -
Свържи базата
В Appsmith: Create new → Application, после Data → Datasources → PostgreSQL (имената на менютата може да са се променили — ⚠️ виж документацията). Попълни:
Поле Стойност Host address postgres— името на услугата, неlocalhostPort 5432Database name dashboardUsername dash_appPassword стойността на DASH_PASSWORDот.envConnection mode Read/Write (запазваме брифинга; правата ограничава самата роля) SSL mode Disable (трафикът е във вътрешната мрежа на Docker) Натисни Test, после Save. Паролата да я видиш:
grep DASH_PASSWORD .env.⚠️Никога не слагай собственика на базатаПаролата наdash_ownerне е за таблото. Ако таблото получи грешка „permission denied“, добави нужното право наdash_app, а не го сменяй със собственика. -
Заявките на таблото
Във всяка страница на приложението добави заявка (Queries → New query върху базата) и ѝ дай името отляво. Настройката „Run behavior“ (в зъбчатото колело на заявката) остави на On page load — така данните се зареждат при отваряне. Цените са в EUR.
sql · Appsmith заявки-- qAlerts: активни сигнали (последните 24 ч) SELECT count(*) AS active_alerts FROM tickets WHERE status = 'open' AND created_at > now() - interval '24 hours'; -- qUnpaid: просрочени неплатени фактури SELECT count(*) AS unpaid, COALESCE(sum(amount_eur), 0) AS total_owed FROM invoices WHERE status = 'pending' AND due_date < current_date; -- qUnpaidList: списък за таблицата SELECT client, amount_eur, due_date FROM invoices WHERE status = 'pending' AND due_date < current_date ORDER BY due_date LIMIT 20; -- qDevices: устройства на линия SELECT count(*) FILTER (WHERE online) AS online, count(*) AS total FROM devices; -- qToday: приход днес (EUR) SELECT COALESCE(sum(amount_eur), 0) AS today_revenue FROM invoices WHERE status = 'paid' AND paid_at::date = current_date; -- qWeek: приход по дни, последните 7 дни (за графиката) SELECT paid_at::date AS day, sum(amount_eur) AS revenue FROM invoices WHERE status = 'paid' AND paid_at >= current_date - 6 GROUP BY 1 ORDER BY 1; -- lastBriefing: последният брифинг SELECT created_at, body FROM briefings ORDER BY id DESC LIMIT 1;С демонстрационните данни очакваш: 2 активни сигнала, 2 просрочени фактури на обща стойност 570,50 EUR, 3 устройства на линия от 4 и 310,00 EUR приход днес. Числата зависят от часа, в който си заредил данните — ако нещо не излиза, пусни заявката с Run и виж отговора.
-
Подреди екрана
Хвани уиджетите от лявата лента и ги пусни върху платното. Всеки се свързва със заявка чрез обвързване във фигурни скоби
{{ }}.Секция Данни Опресняване Уиджет Активни сигнали qAlerts30 с Stats Box → {{qAlerts.data[0].active_alerts}}Неплатени фактури qUnpaid60 с Stats Box → {{qUnpaid.data[0].total_owed}}EURПросрочени — списък qUnpaidList60 с Table → {{qUnpaidList.data}}Устройства на линия qDevices30 с Stats Box → {{qDevices.data[0].online}} / {{qDevices.data[0].total}}Приход днес qToday60 с Stats Box → {{qToday.data[0].today_revenue}}EURПриход за 7 дни qWeek60 с Chart → {{qWeek.data}}Сутрешен брифинг lastBriefingна бутон Text → {{lastBriefing.data[0].body}}Интервалите в таблицата са тези от функцията
startRefreshв стъпка 12 — смениш ли едното, смени и другото.Ако Stats Box иска сума с два знака след запетаята:
{{Number(qToday.data[0].today_revenue).toFixed(2)}}. Числата отnumericв Postgres идват като низове, затова е добре да ги превърнеш сNumber(). -
Моделът: изтегли го и го свържи през REST API
Моделите се теглят вътре в контейнера на Ollama и стоят в тома
ollama_models.bashdocker compose exec ollama ollama pull llama3.1 docker compose exec ollama ollama listПо ollama.com
llama3.1(8B) е около 4,9 GB. Паметта е обща с процесора — не пускай няколко големи модела наведнъж. ⚠️ Скоростта на отговорите на твоята машина не сме мерили.В Appsmith: Datasources → REST API, URL
http://ollama:11434, запази. После нова заявка върху нея, нареченаollamaChat:Настройка Стойност Метод и път POST · /api/chatHeader Content-Type: application/jsonBody JSON, виж по-долу Run behavior Manual (иначе моделът се пуска при всяко отваряне на страницата) Query timeout 60000 ms (по подразбиране е 10000; документацията дава най-много 60000). При самостоятелна инсталация сървърният срок може да се вдигне над 60 секунди с променливата APPSMITH_SERVER_TIMEOUT(в секунди) вenvironmentна Appsmith — нужно е при по-голям модел. ⚠️ Не сме го пробвали.json · тяло на заявката ollamaChat{ "model": "llama3.1", "stream": false, "keep_alive": "10m", "options": { "temperature": 0.2 }, "messages": [ { "role": "system", "content": "Ти си помощник на управителя. Пиши на български, 3 до 5 кратки изречения, само по дадените числа. Не измисляй факти." }, { "role": "user", "content": {{ Briefing.buildPrompt() }} } ] }💡Защоstream: falseПо подразбиране Ollama връща отговора на парчета (поток от JSON редове), а Appsmith очаква един отговор. Сfalseполучаваш цялото съобщение наведнъж и текстът е вmessage.content. Затова ползваме/api/chatсъс съобщения и роли (systemиuser), а не/api/generateс единprompt.⚠️Адресът е на услугата, не на мрежатаhttp://ollama:11434работи, защото Appsmith и Ollama са в един compose проект. Не пишиlocalhost(това е контейнерът на Appsmith) и не отваряй Ollama към0.0.0.0— така моделът става достъпен за цялата мрежа. -
JS обект: брифинг от бутон и живи числа
Нов JS обект (JS Objects → New) с име
Briefing. Той събира числата в кратък текст, вика модела, записва резултата и опреснява текста на екрана. ЗаявкаsaveBriefingе обикновена SQL заявка (Run behavior: Manual) върху същата база:sql · saveBriefingINSERT INTO briefings (model, body) VALUES ('llama3.1', {{ this.params.text }});javascript · JS обект Briefingexport default { buildPrompt() { const a = qAlerts.data[0]; const u = qUnpaid.data[0]; const d = qDevices.data[0]; const t = qToday.data[0]; return "Данни за деня:\n" + "- Активни сигнали: " + a.active_alerts + "\n" + "- Просрочени фактури: " + u.unpaid + " на обща стойност " + u.total_owed + " EUR\n" + "- Устройства на линия: " + d.online + " от " + d.total + "\n" + "- Приход днес: " + t.today_revenue + " EUR\n" + "Напиши кратък сутрешен доклад и предложи един приоритет."; }, async generate() { await ollamaChat.run(); const text = ollamaChat.data.message.content; await saveBriefing.run({ text: text }); await lastBriefing.run(); showAlert("Брифингът е записан", "success"); }, startRefresh() { setInterval(() => { qAlerts.run(); qDevices.run(); }, 30000, "fast"); setInterval(() => { qUnpaid.run(); qUnpaidList.run(); qToday.run(); qWeek.run(); }, 60000, "slow"); }, stopRefresh() { clearInterval("fast"); clearInterval("slow"); } }Закачи: бутон „Нов брифинг“ → onClick → Execute a JS function → Briefing.generate. За живите числа: Page → On page load → Briefing.startRefresh (или бутон, ако искаш да го контролираш).
setIntervalе функция на Appsmith с подписsetInterval(функция, милисекунди, id);idслужи за спиране сclearInterval.✅Опреснявай заявките, не моделаИнтервалът вика само SQL заявките — те са евтини. Моделът се вика само от бутона: всяко извикване заема видеокартата и общата памет.✅Човек чете и решаваБрифингът е препоръка, а не решение. Ако таблото започне да изпраща съобщения или да променя данни, нека минава през одобрение от човек — моделът греши и измисля. -
Сигурност — минимумът
.envе с права 600, не е в Git и не се праща никому.- Публикуван е само
127.0.0.1:8080; Postgres и Ollama нямат публикувани портове. - Таблото влиза с
dash_app(чете и пише само вbriefings), никога със собственика. - Не слагай
0.0.0.0пред Ollama и не отваряй Appsmith към интернет без HTTPS и защита (Set up custom domain and SSL — виж документацията). - Паролата на администратора на Appsmith е дълга и уникална.
-
Копия, обновяване и следене
bash · от ~/dashboard-gx10mkdir -p backups docker compose exec -T postgres sh -c 'pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB"' > backups/dashboard-db-$(date +%Y%m%d).sql docker compose exec appsmith appsmithctl backupПървата команда копира данните. Втората (
appsmithctl backup) копира самото приложение на Appsmith — екраните, заявките и настройките. По документацията: пуснато в терминал, пита за парола, с която шифрова копието (запази я, без нея копието не се възстановява), а файлът пада в./stacks/data/backup/. Пази копията и извън машината.Обновяване. Сменяш числото в
.env(APPSMITH_VERSION,OLLAMA_VERSION) по текущите издания в Docker Hub на Appsmith и на Ollama, и пускаш (първо направи копие):bashdocker compose pull docker compose up -d --remove-orphans docker compose logs -f appsmith --tail=50Не сменяй основната версия на Postgres просто с нов таг — това изисква отделна процедура (виж документацията на Postgres). Преди скок на Appsmith между големи версии прочети указанията в документацията му за обновяване.
Следене.
docker compose psпоказва състоянието,docker stats --no-stream— процесор и памет на контейнерите.
04Проверка
docker compose ps: Postgres еhealthy, Ollama и Appsmith работят.init.sqlе минал без грешки, аdash_appне може да трие таблици.- Appsmith се отваря през тунела и имаш администраторски акаунт.
- Тестът на връзката към базата е успешен и четирите числа показват стойности от демонстрационните данни.
- Заявката
ollamaChatвръща текст вmessage.content. - Бутонът „Нов брифинг“ записва ред в
briefingsи текстът се показва на екрана. - Само
127.0.0.1:8080е публикуван. - Има копие на базата и копие на Appsmith.
Тест
1. Кой адрес на Postgres вписваш в Appsmith в този стек?
2. Защо таблото влиза с ролята dash_app, а не със собственика на базата?
3. Защо в тялото към /api/chat има "stream": false?
4. Кое НЕ бива да се пуска от setInterval на всеки 30 секунди?
05Какво следва
06Източници
- Appsmith: инсталиране с Docker — образ, портове,
/appsmith-stacks, 8 GB памет,cs.appsmith.com, Community или Commercial. - Appsmith: лиценз (Apache 2.0) · appsmith-ce в Docker Hub — версия v2.4.3 и архитектури (arm64).
- Appsmith: PostgreSQL · връзка към база в Docker — полета на връзката, име на контейнера като хост.
- Appsmith: настройки на заявките — Run behavior, срок 10 s до 60 s.
- Appsmith: setInterval() · параметри към заявки · телеметрия · appsmithctl.
- Ollama: API /api/chat 🔒 локално — съобщения,
stream,keep_alive,options. - Postgres в Docker Hub · Ollama в Docker Hub — тагове и архитектури (arm64).
- Docker Compose: достъп до GPU · llama3.1 🔒 локално — размер на модела.