Vostok LinuxVostok Linux

XBPS Package Manager

XBPS — The X Binary Package System

XBPS is the native package manager of Void Linux — and therefore of Vostok Linux. It was developed from scratch by the Void team and is one of the fastest, most reliable package managers in the Linux world. If you've used apt, pacman, or dnf before — XBPS will feel familiar but faster and more transparent.

Everything in Vostok Linux is managed through XBPS. Packages are binary — you download pre-compiled software, not source code. This means installations are instant compared to source-based systems.

Why XBPS?

  • Fast — dependency resolution and downloads are extremely quick
  • Safe — checks library compatibility before installing to prevent broken systems
  • Reliable — atomic operations mean a failed install never leaves your system half-broken
  • Simple — a small set of commands covers everything you need
  • Transparent — every operation shows exactly what it's doing
  • Rolling release ready — designed for continuous updates without version migrations

The Two Main Tools

XBPS has two primary commands:

  • xbps-install — install packages and sync repositories
  • xbps-remove — remove packages
  • xbps-query — search and inspect packages
  • xbps-pkgdb — manage the package database
  • xbps-reconfigure — reconfigure installed packages

Installing Packages

Install a single package:

sudo xbps-install -S package-name

Install multiple packages at once:

sudo xbps-install -S package1 package2 package3

The -S flag syncs the repository index before installing. Always use it.

Updating the System

Sync repositories and upgrade all packages:

sudo xbps-install -Su

This is the only command you need to keep Vostok fully up to date. Run it regularly.

Sync repositories only (without installing anything):

sudo xbps-install -S

Removing Packages

Remove a package:

sudo xbps-remove package-name

Remove a package and all its orphaned dependencies:

sudo xbps-remove -R package-name

Remove orphaned packages (installed as dependencies but no longer needed):

sudo xbps-remove -o

Remove cached package files to free up disk space:

sudo xbps-remove -O

Searching for Packages

Search by name or description:

xbps-query -Rs "search-term"

The -R flag searches the remote repository. Without it, only installed packages are searched.

Search for an exact package name:

xbps-query -Rs "^firefox$"

Inspecting Packages

Show full information about a package (remote):

xbps-query -R package-name

Show information about an installed package:

xbps-query package-name

List all files installed by a package:

xbps-query -f package-name

Show dependencies of a package:

xbps-query -x package-name

Show reverse dependencies — what depends on a package:

xbps-query -X package-name

Listing Installed Packages

List all installed packages:

xbps-query -l

List only manually installed packages (not pulled in as dependencies):

xbps-query -m

Count total installed packages:

xbps-query -l | wc -l

Finding Which Package Owns a File

If you have a file and want to know which package installed it:

xbps-query -o /path/to/file

Example:

xbps-query -o /usr/bin/firefox

Holding a Package (Prevent Updates)

Put a package on hold so it doesn't get updated:

sudo xbps-pkgdb -m hold package-name

Remove the hold:

sudo xbps-pkgdb -m unhold package-name

List all held packages:

xbps-query -l | grep "h "

Reconfiguring a Package

If a package is installed but not working correctly, reconfigure it:

sudo xbps-reconfigure -f package-name

Reconfigure all packages:

sudo xbps-reconfigure -a

Repository Management

Show configured repositories:

xbps-query -L

Repository files are stored in:

/etc/xbps.d/

Vostok Linux adds its own repository automatically via the vostok-mirrorlist package. You get all official Void packages plus Vostok's extended repository.

Checking for Broken Packages

Check the package database for inconsistencies:

sudo xbps-pkgdb -a

Check a specific package:

sudo xbps-pkgdb package-name

Downgrading a Package

If an update breaks something, you can install a specific version from the package cache:

sudo xbps-install --repository=/var/cache/xbps package-name-version

List cached package versions:

ls /var/cache/xbps/

Useful Combinations

Update system and remove orphans in one go:

sudo xbps-install -Su && sudo xbps-remove -o

Full system maintenance:

sudo xbps-install -Su && sudo xbps-remove -o && sudo xbps-remove -O

🔍 Diagnostics

Check XBPS version:

xbps-query --version

Verify all installed packages are consistent:

sudo xbps-pkgdb -a

Show XBPS configuration:

cat /etc/xbps.d/*.conf

Check available disk space before a large install:

df -h /

⚠️ Common Issues

xbps-install: No such package — package not found

Sync the repository first:

sudo xbps-install -S

Then try again. If still not found, the package may be in the nonfree or multilib repository:

sudo xbps-install -S void-repo-nonfree
sudo xbps-install -S

Dependency conflicts during update

Force a full sync and update:

sudo xbps-install -Suf

Broken package database

Rebuild the database:

sudo xbps-pkgdb -a

Slow downloads

Check your configured mirror. Edit /etc/xbps.d/vostok-mirrorlist.conf and switch to a mirror closer to your location.

Package installed but command not found

Reconfigure the package:

sudo xbps-reconfigure -f package-name

Then check if the binary exists:

which command-name

For deeper XBPS documentation, see:

XBPS — X Binary Package System

XBPS — нативный пакетный менеджер Void Linux — и соответственно Vostok Linux. Он разработан с нуля командой Void и является одним из самых быстрых и надёжных пакетных менеджеров в мире Linux. Если вы использовали apt, pacman или dnf раньше — XBPS покажется знакомым, но быстрее и прозрачнее.

Всё в Vostok Linux управляется через XBPS. Пакеты бинарные — вы загружаете предскомпилированное ПО, а не исходный код. Это означает мгновенные установки по сравнению с системами на основе исходников.

Почему XBPS?

  • Быстрый — разрешение зависимостей и загрузки очень быстрые
  • Безопасный — проверяет совместимость библиотек перед установкой чтобы предотвратить поломку системы
  • Надёжный — атомарные операции означают что неудавшаяся установка никогда не оставит систему наполовину сломанной
  • Простой — небольшой набор команд покрывает всё что нужно
  • Прозрачный — каждая операция показывает точно что происходит
  • Готов к rolling release — создан для непрерывных обновлений без миграций версий

Два основных инструмента

XBPS имеет несколько основных команд:

  • xbps-install — установка пакетов и синхронизация репозиториев
  • xbps-remove — удаление пакетов
  • xbps-query — поиск и просмотр пакетов
  • xbps-pkgdb — управление базой данных пакетов
  • xbps-reconfigure — перенастройка установленных пакетов

Установка пакетов

Установить один пакет:

sudo xbps-install -S имя-пакета

Установить несколько пакетов сразу:

sudo xbps-install -S пакет1 пакет2 пакет3

Флаг -S синхронизирует индекс репозитория перед установкой. Всегда используйте его.

Обновление системы

Синхронизировать репозитории и обновить все пакеты:

sudo xbps-install -Su

Это единственная команда для поддержания Vostok полностью актуальным. Запускайте регулярно.

Только синхронизировать репозитории (без установки):

sudo xbps-install -S

Удаление пакетов

Удалить пакет:

sudo xbps-remove имя-пакета

Удалить пакет и все его осиротевшие зависимости:

sudo xbps-remove -R имя-пакета

Удалить осиротевшие пакеты (установленные как зависимости, но больше не нужные):

sudo xbps-remove -o

Удалить кешированные файлы пакетов для освобождения места:

sudo xbps-remove -O

Поиск пакетов

Поиск по имени или описанию:

xbps-query -Rs "поисковый-запрос"

Флаг -R ищет в удалённом репозитории. Без него ищет только среди установленных.

Поиск точного имени пакета:

xbps-query -Rs "^firefox$"

Просмотр информации о пакете

Полная информация о пакете (удалённом):

xbps-query -R имя-пакета

Информация об установленном пакете:

xbps-query имя-пакета

Список всех файлов установленных пакетом:

xbps-query -f имя-пакета

Зависимости пакета:

xbps-query -x имя-пакета

Обратные зависимости — что зависит от пакета:

xbps-query -X имя-пакета

Список установленных пакетов

Все установленные пакеты:

xbps-query -l

Только вручную установленные пакеты (не зависимости):

xbps-query -m

Подсчёт общего числа установленных пакетов:

xbps-query -l | wc -l

Найти какой пакет владеет файлом

Если у вас есть файл и вы хотите знать какой пакет его установил:

xbps-query -o /путь/к/файлу

Пример:

xbps-query -o /usr/bin/firefox

Удержание пакета (запрет обновлений)

Поставить пакет на удержание чтобы он не обновлялся:

sudo xbps-pkgdb -m hold имя-пакета

Снять удержание:

sudo xbps-pkgdb -m unhold имя-пакета

Список всех удерживаемых пакетов:

xbps-query -l | grep "h "

Перенастройка пакета

Если пакет установлен но не работает корректно, перенастройте его:

sudo xbps-reconfigure -f имя-пакета

Перенастроить все пакеты:

sudo xbps-reconfigure -a

Управление репозиториями

Показать настроенные репозитории:

xbps-query -L

Файлы репозиториев хранятся в:

/etc/xbps.d/

Vostok Linux добавляет свой репозиторий автоматически через пакет vostok-mirrorlist. Вы получаете все официальные пакеты Void плюс расширенный репозиторий Vostok.

Проверка сломанных пакетов

Проверить базу данных пакетов на несоответствия:

sudo xbps-pkgdb -a

Проверить конкретный пакет:

sudo xbps-pkgdb имя-пакета

Откат пакета

Если обновление что-то сломало, можно установить конкретную версию из кеша:

sudo xbps-install --repository=/var/cache/xbps имя-пакета-версия

Список кешированных версий пакетов:

ls /var/cache/xbps/

Полезные комбинации

Обновить систему и удалить сироты за один раз:

sudo xbps-install -Su && sudo xbps-remove -o

Полное обслуживание системы:

sudo xbps-install -Su && sudo xbps-remove -o && sudo xbps-remove -O

🔍 Диагностика

Проверить версию XBPS:

xbps-query --version

Проверить консистентность всех установленных пакетов:

sudo xbps-pkgdb -a

Показать конфигурацию XBPS:

cat /etc/xbps.d/*.conf

Проверить свободное место перед большой установкой:

df -h /

⚠️ Частые проблемы

xbps-install: No such package — пакет не найден

Сначала синхронизируйте репозиторий:

sudo xbps-install -S

Затем попробуйте снова. Если всё равно не найден, пакет может быть в репозитории nonfree:

sudo xbps-install -S void-repo-nonfree
sudo xbps-install -S

Конфликты зависимостей при обновлении

Принудительная полная синхронизация и обновление:

sudo xbps-install -Suf

Сломанная база данных пакетов

Пересоздать базу данных:

sudo xbps-pkgdb -a

Медленная загрузка

Проверьте настроенное зеркало. Отредактируйте /etc/xbps.d/vostok-mirrorlist.conf и переключитесь на зеркало ближе к вашему местоположению.

Пакет установлен но команда не найдена

Перенастройте пакет:

sudo xbps-reconfigure -f имя-пакета

Затем проверьте существует ли бинарный файл:

which имя-команды

Для более глубокой документации по XBPS см.: