Об этом проекте

Umami представлена как платформа аналитики, ориентированная на конфиденциальность, которая объединяет данные о трафике, кампаниях, поведении, конверсиях и доходах в одном месте. В проекте подчеркивается, что он не использует cookies или методы слежки и может работать либо в режиме self-hosted, либо через облачный сервис. В README приведена ссылка на публичное демо, а каналы поддержки проекта включают GitHub, Twitter, LinkedIn и Discord. Код выпущен под лицензией MIT. Установка из исходного кода требует сервера с Node.js 18.18 или новее и базы данных PostgreSQL (версии 12.14 или новее). Документированный процесс включает клонирование репозитория, установку зависимостей с помощью pnpm, создание файла `.env` со строкой подключения `DATABASE_URL`, запуск сборки и последующий запуск приложения. Этап сборки при первой установке создает таблицы базы данных, а также создает пользователя для входа с именем `admin` и паролем `umami`. По умолчанию приложение запускается на `http://localhost:3000`, поэтому в документации отмечается, что обычно потребуется проксировать запросы с веб-сервера или изменить порт для прямого обслуживания. Документировано несколько переменных окружения. `API_URL` позволяет изменить базовый URL, используемый для внутренних API-вызовов интерфейса; относительные пути обслуживаются в рамках `BASE_PATH`, а абсолютные URL проксируются через локальный маршрут `/api`. `TWO_FACTOR_ENCRYPTION_KEY` — 64-символьная шестнадцатеричная строка, созданная, например, с помощью `openssl rand -hex 32`, включает двухфакторную аутентификацию; пока она не установлена, двухфакторная аутентификация недоступна и не может быть обязательной. Для контейнеризированного развертывания проект публикует Docker-образы и предоставляет файл Docker compose, который запускает Umami вместе с базой данных PostgreSQL. Обновления выполняются либо путем получения исходного кода, переустановки зависимостей и пересборки, либо путем загрузки новых образов и пересоздания контейнеров с помощью Docker compose. Подробное руководство по началу работы размещено на сайте документации проекта.