Karakeep (ранее Hoarder) — открытый менеджер закладок, рассчитанный на самостоятельное размещение. Он сохраняет ссылки, заметки, изображения и PDF, извлекает содержимое страниц, помогает организовать архив и при желании использует языковые модели для тегирования и саммари.

Материал актуализирован по официальной документации, тарифам и релизам 7 сентября 2026 года. Текущая стабильная версия на эту дату — 0.33.2.

Что хранит и как помогает искать

Karakeep относится к приложениям категории «сохрани что угодно». В общую библиотеку можно добавить URL, текстовую заметку или файл. Для ссылок сервис автоматически получает заголовок, описание и изображение, а сохранённые материалы распределяются по спискам и тегам.

Проект поддерживает полнотекстовый поиск. Начиная с ветки 0.33 также доступны экспериментальные семантический и гибридный режимы: они ищут материалы по смыслу с помощью векторных представлений текста, даже если запрос и сохранённая страница используют разные слова. Для этих режимов нужно отдельно включить embeddings — векторные представления текста.

Проект вырос из Hoarder и позднее получил нынешнее название. На 7 сентября 2026 года у репозитория около 28,9 тыс. звёзд на GitHub, а актуальный релиз имеет номер 0.33.2.

💡
Self-hosting — размещение сервиса на собственном VPS, NAS или мини-ПК. Вы контролируете данные, но самостоятельно отвечаете за обновления, доступность и резервные копии.

Основные возможности

ГруппаЧто умеет Karakeep
СохранениеСсылки, текстовые заметки, изображения и PDF; автоматическое получение заголовка, описания и превью
ОрганизацияСписки, теги, совместные списки, массовые действия и движок правил
ИИАвтоматические теги и саммари через языковые модели, поддержка локальных моделей через Ollama, распознавание текста на изображениях
ПоискПолнотекстовый поиск, а также экспериментальные семантический и гибридный режимы при включённых embeddings
АрхивацияПолные копии страниц через Monolith, архивирование видео через yt-dlp и сохранение выделенных фрагментов
Захват и чтениеРасширения Chrome, Firefox и Safari; приложения iOS и Android; RSS; синхронизация с браузерными закладками через floccus; офлайн-чтение в мобильном приложении
ИнтеграцииREST API, CLI, MCP-сервер, официальные skills для ИИ-агентов, SSO и импорт из других сервисов

В версии 0.33.1 мобильное приложение получило офлайн-чтение. Отдельные статьи можно загрузить на устройство, а недавно открытые списки, теги и другие экраны сохраняются в локальном кеше на семь дней.

Установка через Docker Compose

Для установки нужны Docker и Docker Compose. Официальный compose-файл настраивает постоянное хранилище и связи между сервисами.

  1. Создайте рабочий каталог и перейдите в него:
mkdir karakeep-app
cd karakeep-app
  1. Скачайте официальный compose-файл:
wget https://raw.githubusercontent.com/karakeep-app/karakeep/main/docker/docker-compose.yml
  1. Сгенерируйте два разных секрета. Каждую команду выполните отдельно и сохраните результат:
openssl rand -base64 36
openssl rand -base64 36
  1. Создайте рядом с compose-файлом файл .env:
KARAKEEP_VERSION=release
NEXTAUTH_SECRET=<первый_случайный_секрет>
MEILI_MASTER_KEY=<второй_случайный_секрет>
NEXTAUTH_URL=http://localhost:3000

# Необязательно: автоматическое тегирование через OpenAI
OPENAI_API_KEY=<ваш_API-ключ>

Если сервис будет доступен по домену, замените NEXTAUTH_URL на его внешний адрес, например https://karakeep.example.com.

KARAKEEP_VERSION=release указывает на последнюю стабильную версию. Для контролируемых обновлений можно закрепить конкретный номер релиза, например KARAKEEP_VERSION=0.33.2, и менять его вручную после изучения примечаний к выпуску.

  1. Запустите сервис:
docker compose up -d
  1. Откройте http://localhost:3000 при локальной установке или адрес своего сервера. Должна появиться страница входа.
⚠️
Внимание: не публикуйте .env и не сохраняйте его в открытом репозитории. В нём находятся секрет приложения, ключ Meilisearch и, при использовании внешней модели, API-ключ провайдера.

После изменения .env снова выполните docker compose up -d. Если используется канал release, для принудительной загрузки свежих образов официальная документация рекомендует:

docker compose up --pull always -d

При закреплённой версии измените KARAKEEP_VERSION, затем выполните обычный запуск Compose. Перед обновлением Meilisearch отдельно проверьте официальную инструкцию по миграции для нужной версии.

Релиз 0.33.2 перевёл стандартную конфигурацию на собственный контейнер Karakeep Chrome вместо заброшенного образа alpine-chrome. При обновлении старой установки проверьте руководство по миграции, указанное в примечаниях к релизу.

Подключение ИИ и API

Автоматическое тегирование необязательно: без языковой модели Karakeep остаётся обычным менеджером закладок, а теги можно добавлять вручную. Официальная документация поддерживает OpenAI и альтернативных провайдеров, включая локальный Ollama. Точные параметры выбранного провайдера следует брать из актуального раздела конфигурации, поскольку набор переменных и рекомендуемые модели меняются.

REST API позволяет программно управлять закладками, списками, тегами, выделениями, файлами и резервными копиями. API-ключ создаётся в веб-интерфейсе: Settings → API Keys. Запросы используют Bearer-токен в заголовке Authorization.

curl \
  -H "Authorization: Bearer $KARAKEEP_API_KEY" \
  "https://karakeep.example.com/api/v1/bookmarks?limit=10"

Списковые методы используют курсорную пагинацию. Если поле nextCursor равно null, следующей страницы нет. Начиная с версии 0.32 API-ключам можно назначать отдельные области доступа, что полезно при подключении CLI и ИИ-агентов.

Как проверить результат

После первого запуска выполните минимальную проверку:

  1. Откройте страницу входа и создайте учётную запись.
  2. Добавьте публичную веб-страницу как закладку.
  3. Дождитесь появления заголовка и превью.
  4. Найдите сохранённую страницу через полнотекстовый поиск.
  5. Перезапустите контейнеры командой docker compose restart и убедитесь, что закладка сохранилась.
  6. Если подключена языковая модель, добавьте новый материал и проверьте появление автоматических тегов или саммари.
  7. Если настроен API, выполните запрос списка закладок и убедитесь, что сервер вернул созданный объект.
📌
Успешный запуск контейнеров подтверждает только работу процессов. Сохранение закладки после перезапуска отдельно проверяет постоянное хранилище, а поиск и API — соответствующие пользовательские функции.

Резервные копии и обновления

Self-hosting не защищает данные автоматически. Перед регулярным использованием настройте резервное копирование постоянного хранилища и проверьте восстановление на отдельной установке. Официальный API также содержит методы для работы с резервными копиями, но выбранная стратегия должна учитывать всю конфигурацию и сохранённые файлы экземпляра.

Обновления лучше выполнять после просмотра примечаний к релизу. Это особенно существенно для изменений контейнера браузера, Meilisearch и других компонентов, которым может потребоваться отдельная миграция.

Тарифы и лимиты

Данные проверены 7 сентября 2026 года по официальной странице тарифов. Karakeep Cloud уже работает как действующий сервис, а не как public beta.

ПланЦенаОсновные лимиты
Self-HostedБесплатноНеограниченные закладки и хранилище со стороны приложения; инфраструктуру предоставляет пользователь
Cloud Free$010 закладок, 20 МБ
Cloud Pro$4 в месяц или $40 в год50 000 закладок, 50 ГБ, ИИ-теги и полнотекстовый поиск
CorporateИндивидуально, за пользователяУправляемое развёртывание, собственный домен, SSO, управление пользователями и приоритетная поддержка

В self-hosted-версии доступны все функции, однако фактический объём библиотеки ограничивают диск, память и производительность вашей инфраструктуры. У облачных тарифов условия могут измениться, поэтому перед оплатой проверьте официальную страницу цен.

Полезные сценарии

Личный архив вместо сервиса «прочитать позже»

Исходные данные — экспорт закладок из поддерживаемого сервиса или браузера. Импортируйте библиотеку, добавляйте новые страницы через расширение и проверяйте их поиском. Результат — доступный вам архив с копиями страниц и тегами. Сценарий требует обслуживания сервера и резервных копий; без них self-hosting создаёт единственную точку отказа.

База материалов для исследования

Сохраняйте статьи, заметки, изображения и PDF по одному проекту в общий список. Добавляйте ручные или автоматические теги, выделяйте важные фрагменты и используйте полнотекстовый поиск. При включённых embeddings можно дополнительно попробовать семантический или гибридный режим. Эти режимы в версии 0.33 помечены как экспериментальные, поэтому точность результатов следует проверять вручную.

Доступ для ИИ-агента

Создайте API-ключ с минимально необходимыми областями доступа и подключите CLI, MCP или официальный skill. Агент сможет находить и добавлять материалы в пределах выданных прав. Результат проверяется появлением тестовой закладки и запросом к API. Не выдавайте права на удаление или администрирование, если они не нужны сценарию.

Чтение без сети

В мобильном приложении выберите для нужной статьи действие Make available offline. После загрузки откройте её без подключения к сети. Эта возможность относится к мобильному приложению и требует заранее отметить конкретные статьи; семидневный кеш недавно просмотренных экранов не заменяет явную загрузку материала для офлайн-чтения.

Когда Karakeep может не подойти

  • Если вы не хотите обслуживать сервер, следить за обновлениями и проверять резервные копии, проще использовать Karakeep Cloud или другой управляемый сервис.
  • Если нужна только синхронизация обычных закладок без архивирования, поиска по содержимому и ИИ, Karakeep может оказаться избыточным.
  • Если основная задача — вести сеть заметок в локальных Markdown-файлах, ближе по модели работы будет Obsidian.
  • Если семантический поиск критичен для рабочего процесса, учитывайте его экспериментальный статус в ветке 0.33 и сначала проверяйте качество на своей библиотеке.

Официальные ссылки

Следующий шаг

Если вы сравниваете варианты самостоятельного хранения личных данных, посмотрите Nextcloud — self-hosted платформа для файлов, совместной работы и коммуникаций.

Если вы выбираете архитектуру личного или командного хранилища, полезно заранее сопоставить требования к приватности, поиску, резервным копиям и стоимости сопровождения.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov