Початок роботи

Побачте його в дії за 5 хвилин#

Вам не потрібен сервер, хостинг-провайдер або IT-відділ. Якщо у вас є ноутбук із встановленим Docker, ви можете побачити Observer у роботі прямо зараз.

git clone https://github.com/lbrty/observer.git
cd observer
cp .env.example .env
just generate-keys
just docker-up
just run

Відкрийте http://localhost:9000/health у браузері. Якщо ви бачите "status":"healthy", бекенд працює.

Потім запустіть веб-інтерфейс:

just web-dev

Відкрийте http://localhost:5173 — ви дивитесь на Observer.

Що ви щойно запустили#

• Бекенд, що обслуговує API — обробляє автентифікацію, зберігання даних та звіти
• Базу даних з таблицями для людей, домогосподарств, записів підтримки, історії міграції, документів та тварин
• Веб-інтерфейс з управлінням проєктами, рольовим доступом та вбудованою звітністю
• Автоматичну безпеку входу — токени ротуються при кожному оновленні сесії

Все це працює на одній машині. У продакшені це компілюється в один файл, який можна скопіювати на будь-який сервер.

Готові до реального розгортання?#

Щоб перейти від «пробую» до «моя команда використовує це щодня», вам потрібно:

Без підписки. Без плати за користувача. Без прив’язки до постачальника. Ви володієте даними та розгортанням.

Дивіться Розгортання для покрокового налаштування продакшену.

Для розробників: локальне налаштування#

Якщо ви хочете працювати над самим Observer, вам потрібні такі інструменти:

1. Клонуйте та встановіть залежності#

git clone https://github.com/lbrty/observer.git
cd observer
go mod download
bun install

2. Налаштуйте середовище#

cp .env.example .env

Значення за замовчуванням працюють одразу з наданим docker-compose.yml. Редагування не потрібне.

3. Згенеруйте ключі підпису#

just generate-keys

Це створює пару ключів, які Observer використовує для підпису токенів входу. Директорія keys/ додана в gitignore — кожний розробник генерує свої власні.

4. Запустіть все#

just docker-up    # starts PostgreSQL and Redis
just run          # starts the backend on :9000 (runs migrations automatically)
just web-dev      # starts the frontend on :5173

Щось не працює?#

Порт 5432 вже використовується — Ймовірно, у вас працює локальний PostgreSQL. Зупиніть його або змініть порт у docker-compose.yml.

“no such file or directory” для шляхів до ключів — Спочатку потрібно виконати just generate-keys.

Міграція не вдалася з “connection refused” — Контейнер бази даних може бути ще не готовий. Зачекайте кілька секунд після just docker-up і спробуйте знову.