Langfuse self-hosted разворачивается двумя официальными путями: Docker Compose для теста и локальной разработки, Helm-чарт в Kubernetes для продакшена. Лицензия при этом бесплатна, а вот инфраструктура вокруг нее (Postgres, ClickHouse, Redis, S3) не…
10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.
Об авторе →Claude Code: новый CLI-агент от Anthropic
Anthropic выпустила Claude Code — терминальный AI-агент для разработчиков. Инструмент работает прямо в командной строке и умеет писать, редактировать и запускать код.
Zcode AI: Полный гид по визуальному интерфейсу для Claude Code и AI-агентов
Узнайте, как использовать Zcode для управления Claude Code, Gemini и Codex в едином GUI. Настройка провайдеров, MCP-серверов и визуальный вайбкодинг.
YouTube-канал с монетизацией из любой точки мира: Пошаговый гайд 2026
Инструкция по созданию YouTube-канала: обход блокировок SMS, настройка расширенных функций через виртуальные номера и правила безопасности для монетизации.
Windsurf Code Maps: Как глубоко понимать архитектуру проекта перед написанием кода
Полный гайд по Windsurf Code Maps, модели Sway 1.5 и Sway Grep. Узнайте, как визуализировать архитектуру кода и ускорить разработку в 13 раз.
Vk Fast Cash Strategy
Аудитория ВКонтакте — это те же люди, что и в Instagram, но 'социальный контракт' площадки другой. Если Instagram — это 'дорогой ресторан' с демонстрацией успеха, то VK — это 'душевная шашлычная'. Здесь не работает глянцевый 'успешный успех
Langfuse self-hosted разворачивается двумя официальными путями: Docker Compose для теста и локальной разработки, Helm-чарт в Kubernetes для продакшена. Лицензия при этом бесплатна, а вот инфраструктура вокруг нее (Postgres, ClickHouse, Redis, S3) не помещается в один контейнер и требует отдельного планирования. Разберем, что реально нужно поднять и сколько это будет стоить.
В статье: полный список инфраструктурных зависимостей, команды для Docker Compose и Helm, частые ошибки при self-hosted установке и честная оценка стоимости содержания.
Langfuse self-hosted требует четыре хранилища: Postgres для транзакционных данных, ClickHouse для аналитики трейсов, Redis или Valkey для очередей и кэша, плюс S3-совместимое объектное хранилище для событий.
Официальная документация описывает архитектуру именно так: два контейнера приложения (web и worker) плюс четыре компонента хранения данных, langfuse.com/self-hosting. Это ровно та инфраструктура, что крутится под облачной версией Langfuse Cloud, просто на ваших серверах, а не на их.
Разделение на несколько сервисов не случайное решение архитекторов ради усложнения. Трейсы сначала попадают в S3, и только потом воркер подхватывает их оттуда и пишет в ClickHouse. Прикинь: даже если база временно недоступна, события не теряются, они просто ждут в объектном хранилище своей очереди на обработку. API-ключи и промпты кэшируются в Redis, поэтому каждый запрос к SDK не бьет по основной базе.
Есть и жесткое требование, о котором часто забывают: Postgres и ClickHouse обязаны работать в таймзоне UTC. Не в московской, не в локальной серверной, именно UTC. Иначе аналитика начнет возвращать пустые или неверные данные, а разбираться с этим придется постфактум.
Отдельный контекст 2026 года: в январе ClickHouse купил Langfuse при раунде на 400 млн долларов, объединив под одним брендом базу и продукт, который изначально был построен поверх нее. Для self-hosted это не меняет архитектуру, но объясняет, почему интеграция между Langfuse и ClickHouse Kubernetes Operator развивается быстрее остальных.
Для локального теста или маленькой нагрузки Langfuse поднимается одной командой docker compose up из официального репозитория. Способ не подходит для продакшена: нет отказоустойчивости, масштабирования и бэкапов из коробки.
В документации это написано прямо, без оговорок: Docker Compose лишен high-availability и backup-функциональности, рекомендован только для тестов и низкой нагрузки, langfuse.com/self-hosting/deployment/docker-compose. Для продакшена там же советуют сразу идти в Kubernetes.
Порядок действий простой:
git clone https://github.com/langfuse/langfuse.git
cd langfuse
docker compose upПеред запуском стоит заменить все строки с пометкой CHANGEME в docker-compose.yml, там лежат пароли по умолчанию. Через 2-3 минуты в логах контейнера langfuse-web-1 появится статус "Ready", после этого интерфейс открывается на localhost:3000.
Если планируете разворачивать на VM, а не локально, официальная рекомендация: минимум 4 ядра и 16 ГБ памяти (например t3.xlarge на AWS), диск от 100 ГБ, поскольку трейсы быстро накапливают объем. И один нюанс с медиафайлами: встроенный MinIO по умолчанию недоступен извне контейнерной сети, для загрузки multimodal-контента его нужно донастраивать отдельно.
Официальный Helm-чарт langfuse-k8s разворачивает приложение и все хранилища сразу, либо подключается к уже существующим Postgres, ClickHouse и Redis. Начиная с версии чарта 2.0 нужен Kubernetes 1.28+ и заранее установленные cert-manager и ClickHouse Operator.
Это не мелкая деталь, а условие, при котором helm install просто откажется стартовать: чарт делает preflight-проверку CRD ClickHouse Operator и падает с ошибкой, если их нет в кластере, github.com/langfuse/langfuse-k8s.
Сначала добавляем репозиторий чарта:
helm repo add langfuse https://langfuse.github.io/langfuse-k8s
helm repo updateДальше создаем неймспейс и ставим чарт:
kubectl create namespace langfuse
helm install langfuse langfuse/langfuse -n langfuseРазворачивание займет до 5 минут, поды web и worker несколько раз перезапустятся, пока провижинятся базы, это нормальное поведение, не баг. Проверить статус можно через kubectl get pods -n langfuse. Для первого смок-теста поднимите port-forward до сервиса langfuse-web и откройте интерфейс локально.
Если у вас уже есть managed Postgres или ClickHouse в облаке, чарт умеет подключаться к внешним инстансам через флаги *.deploy: false, вместо того чтобы разворачивать новые. Отдельно стоит знать про переход с версии чарта 1.x на 2.0: там заменили все Bitnami-сабчарты на OSS-альтернативы (ClickHouse Operator, groundhog2k postgres, valkey-io valkey, SeaweedFS для объектного хранилища), и обычный helm upgrade для инстансов со встроенными базами заблокирован, миграция идет через отдельный гайд с параллельным релизом.
Лицензия ядра Langfuse бесплатна, но инфраструктура вокруг нее нет. Минимальная self-hosted установка обходится в несколько сотен долларов в месяц, серьезный продакшен уходит в тысячи, плюс время инженера на поддержку ClickHouse.
Максим: «Мог просто засесть до пяти ночи и просто там править одну какую-то функцию, которая не работала. Если бы не терпение, в моменте я уже испотел и хотелось всё это закрыть. Но я понимал, что это можно решить и нужно решить, чтобы идти дальше.»
Это про вайбкодинг, но один в один описывает вечер с настройкой ClickHouse под нагрузкой. База остается самым капризным компонентом стека, у нее свои правила шардирования, свои требования к памяти, и разобраться с ней с наскока редко получается.
| Уровень нагрузки | Инфраструктура (ориентир, $/мес) | Что чаще всего съедает бюджет |
|---|---|---|
| Минимальный (тест, до 100k событий) | 100-250 | Одна VM под Docker Compose, диск под трейсы |
| Средний (продакшен, команда) | 400-1200 | Кластер Postgres + ClickHouse + Redis, репликация |
| Крупный (высокая нагрузка) | 2000+ | Шардирование ClickHouse, отдельный платформенный инженер |
Часть Enterprise-функций, SSO, кастомизация интерфейса, инструменты автоматизированного провижининга, закрыты лицензионным ключом (EE), это отдельная статья расходов сверх инфраструктуры, langfuse.com/self-hosting/license-key. Считать нужно не "лицензия бесплатна, значит и всё бесплатно", а полную картину: сервера, время на апгрейды между мажорными версиями чарта, мониторинг очереди воркера.
Self-hosting оправдан, когда данные обязаны оставаться внутри вашего периметра по требованиям приватности или регулятора. При небольшом объеме трафика облачный Hobby-тир Langfuse Cloud часто выгоднее по совокупной стоимости, включая время инженера.
У Langfuse Cloud есть щедрый бесплатный Hobby-план без привязки карты, а платные тарифы считаются по метрике событий через биллинг на базе Stripe. Если у вас сотня тысяч событий в месяц и нет требования держать данные локально, эта настройка почти всегда обходится дешевле, чем поддерживать свой ClickHouse-кластер силами одного инженера по остаточному принципу.
| Вариант | Для кого подходит | Слабое место |
|---|---|---|
| Langfuse Cloud | Старт, небольшая и средняя нагрузка, нет требований к резидентности | Данные хранятся у вендора |
| Docker Compose self-hosted | Локальная разработка, PoC, демонстрация | Нет HA, нет бэкапов из коробки |
| Helm в Kubernetes | Продакшен, требования комплаенса, контроль над данными | Нужен K8s 1.28+, cert-manager, инженер под ClickHouse |
Российский контекст добавляет еще один аргумент в пользу self-hosted: без VPN и без иностранных карт платить за облачный сервис не всегда удобно, а свой сервер с Docker решает вопрос независимо от платежных ограничений.
Самые частые проблемы: сервер не в UTC, пропущенный cert-manager перед установкой чарта и попытка запустить Docker Compose как постоянный продакшен без плана на масштабирование.
Таймзона не UTC, наверное, самая обидная ошибка: всё разворачивается без единой ошибки в логах, а потом дашборды показывают пустые графики или неверные цифры. Разработчики Langfuse прямо выносят это в отдельный пункт troubleshooting-документации, langfuse.com/self-hosting/troubleshooting-and-faq.
Вторая по частоте, забытые cert-manager и ClickHouse Operator перед helm install. Чарт версии 2.0 и новее сам проверяет наличие нужных CRD и откажется стартовать без них, так что порядок действий важен: сначала операторы, потом чарт.
Третья, чисто организационная: команда ставит Docker Compose "на попробовать", он неожиданно доживает до продакшена, а потом нагрузка растет и упирается в лимиты одной VM. Документация честно пишет: единственный способ масштабировать Compose-установку это взять сервер побольше, горизонтального масштабирования там нет.
Можно ли развернуть Langfuse без Kubernetes?
Да, через Docker Compose на обычной VM. Подходит для теста и небольшой нагрузки, но без отказоустойчивости и бэкапов из коробки.
Нужна ли платная лицензия для self-hosted Langfuse?
Базовая версия бесплатна и открыта. Часть продвинутых функций, SSO, кастомизация UI, автоматизация доступа, закрыта лицензионным ключом EE.
Что изменилось после покупки Langfuse компанией ClickHouse?
Архитектурно ничего не сломалось, self-hosted установка работает так же. Компании теперь под одним брендом, что ускоряет интеграцию между продуктом и ClickHouse Operator.
Сколько серверов минимум нужно для продакшен-установки?
Формально можно уложиться в один достаточно мощный узел Kubernetes, но для реальной отказоустойчивости обычно закладывают отдельные узлы под Postgres, ClickHouse и воркер.
Можно ли подключить свой managed Postgres вместо встроенного в чарт?
Да, через параметр *.deploy: false в values чарта langfuse-k8s чарт подключится к внешнему инстансу вместо разворачивания нового.
Как обновлять self-hosted Langfuse без долгого простоя?
Долгие миграции при апгрейде выносятся в фоновую задачу и не блокируют обычную работу приложения во время обновления.
Почему дашборды в ClickHouse показывают пустые данные после установки?
В девяти случаях из десяти причина в таймзоне: и Postgres, и ClickHouse обязаны работать строго в UTC.
Self-hosted Langfuse не помещается в один контейнер и не ограничивается словом "бесплатно" в описании лицензии. Для теста хватит Docker Compose и одной VM. Для продакшена придется разобраться с Kubernetes 1.28+, cert-manager, ClickHouse Operator и заложить бюджет не только на сервера, но и на время инженера, который будет разбираться с этим стеком месяцами, а не один вечер.
Если по расчетам self-hosted не окупается при вашем объеме трафика, посмотрите наш разбор Langfuse Cloud vs self-hosted, там подробнее про точку безубыточности. Общий обзор возможностей инструмента, Langfuse: обзор, а если ваш агент уже крутится на своем сервере, пригодится статья про AI-агента 24/7 на VPS. Если вы devops-инженер и настраиваете обсервейшен для своих проектов, загляните в каталог AI-инструментов и агентов на VibeCoderz, там собраны решения под конкретные технические задачи.
Если нужна помощь с архитектурой конкретно под вашу нагрузку, запишитесь на консультацию к Максиму.
Обновлено: август 2026.