Установка приложений Cenaly на Ubuntu
Рабочие места бизнеса часто стоят на Linux: касса у стойки, экран на кухне или в зоне сборки заказов, ПК оператора с гарнитурой. Для них у Cenaly есть нативные программы для Ubuntu — тот же аккаунт, те же точки и данные, что в админке и в Android-приложениях. Подходят любому бизнесу: кафе и ресторану, магазину, салону, отелю, пункту выдачи.
Что нужно для запуска#
| Что | Требование |
|---|---|
| Система | Ubuntu 22.04, 24.04 или 26.04 LTS (рабочий стол GNOME, а также Kubuntu, Xubuntu и другие редакции на той же базе) |
| Процессор | amd64 — обычные ПК и ноутбуки на Intel и AMD; arm64 — компьютеры на ARM |
| Права | пароль администратора (sudo) — для установки пакета |
| Учётка | вход той же почтой и паролем, что в админке Cenaly (владелец или сотрудник с доступом к разделу) |
| Сеть | интернет для входа и работы (данные — в облаке Cenaly) |
Узнать архитектуру своего ПК: откройте «Терминал» и выполните dpkg --print-architecture — ответ amd64 или arm64.
Какие приложения есть#
| Приложение | Пакет | Для кого |
|---|---|---|
| Cenaly Phone | cenaly-phone |
оператор, администратор, ресепшен: звонки через АТС бизнеса, очередь, перевод, история |
| Cenaly KDS | cenaly-kds |
кухня, бар, зона сборки и выдачи заказов: тикеты по станциям, таймеры, «Готово» и «Выдан» |
| Cenaly POS | cenaly-pos |
касса: продажа, оплата, чек, возврат; оборудование — через мост |
| Cenaly Hardware Bridge | cenaly-bridge |
фоновая служба: принтеры чеков и кухни, фискальные кассы, весы, сканеры, денежный ящик |
Программы не зависят друг от друга: ставьте только нужные. Кассе с принтером или фискальной кассой нужен ещё мост — на этом же ПК или на другом ПК точки.
Шаг 1. Скачать пакет#
- Откройте страницу приложения на сайте — например, «Cenaly KDS» в разделе «Приложения».
- В блоке Ubuntu нажмите кнопку своей архитектуры: .deb · amd64 или .deb · arm64. Если браузер сообщил архитектуру, нужная кнопка стоит первой.
- Файл вида
cenaly-kds_1.0.0_amd64.debсохранится в папку «Загрузки».
Кнопка всегда ведёт на последнюю выпущенную версию.
Шаг 2. Установить#
Двойным щелчком. Откройте «Загрузки» и дважды щёлкните по файлу .deb — откроется App Center (в 22.04 — «Ubuntu Software»). Нажмите «Установить» и введите пароль администратора.
Командой. В «Терминале», в папке с файлом:
cd ~/Downloads # или ~/Загрузки
sudo apt install ./cenaly-kds_*_amd64.deb
apt сам доставит нужные системные библиотеки. Точка и косая черта ./ обязательны — без них apt будет искать пакет в интернете, а не файл в папке.
Установка из терминала#
Для серверов, киосков и удалённой установки по SSH есть однострочник: он подключает репозиторий Cenaly (ключ подписи проверяется по отпечатку) и ставит приложение через apt.
| Аккаунт на | Команда |
|---|---|
| cenaly.com и другие брендовые домены | curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- kds |
| cenaly.ru | curl -fsSL https://cdn.cenaly.ru/linux/install.sh | sudo bash -s -- kds |
Вместо kds — phone, pos или bridge; можно несколько через пробел: … -- kds pos. Готовую команду для своего бренда страница приложения показывает с кнопкой «Копировать».
Шаг 3. Первый запуск и вход#
- Откройте меню приложений Ubuntu и найдите Cenaly KDS (Phone, POS).
- Войдите почтой и паролем аккаунта Cenaly или кодом с устройства — так же, как в Android-приложении.
- Выберите точку. Дальше приложение помнит вход: сессия хранится в связке ключей системы (GNOME Keyring), а не открытым файлом.
Phone, KDS и POS живут в трее и запускаются при входе в систему — так кухонный экран не пропустит заказ, а телефон — звонок. Автозапуск выключается в меню значка в трее.
Обновления#
Пакет при установке сам подключает репозиторий Cenaly своего бренда (/etc/apt/sources.list.d/cenaly.sources, подпись — ключом Cenaly). Новые версии приходят вместе с обычными обновлениями Ubuntu — в «Обновлении приложений» или командой:
sudo apt update && sudo apt upgrade
Скачивать файл с сайта заново не нужно. Если ваша политика запрещает сторонние репозитории, создайте файл /etc/default/cenaly со строкой CENALY_APT_REPO=off до установки — тогда обновлять придётся вручную, новым .deb с сайта.
Удаление#
sudo apt remove cenaly-kds # убрать программу, настройки системы оставить
sudo apt purge cenaly-kds # убрать вместе с системными настройками
purge последнего пакета Cenaly на ПК убирает и репозиторий с ключом. Личные данные приложения (кэш, выбранная точка) лежат в домашней папке — ~/.local/share/cenaly/<приложение>; удалите её, если ПК передаёте другому человеку. Тот же результат даёт однострочник: curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- remove kds.
Snap Store#
Snap-версии всех четырёх программ готовятся к публикации в Snap Store. Когда они появятся, на странице приложения будет кнопка Snap Store, а установка — sudo snap install cenaly-kds. Для кассы с фискальным регистратором или весами на USB-COM берите .deb: snap по правилам Ubuntu не видит COM-порты.
Мост оборудования на Ubuntu#
Cenaly Hardware Bridge на Ubuntu — системная служба: стартует при загрузке ПК и сама перезапускается. После установки пакета cenaly-bridge откройте страницу состояния http://127.0.0.1:9100 (ярлык «Cenaly Hardware Bridge» в меню) и привяжите мост к точке — подробно в статье Cenaly Hardware Bridge. Если мост уже стоял прежним однострочником со страницы «Оборудование», пакет подхватит его настройки и привязку — служба останется одна.
Ограничения#
- Push-уведомлений, как на телефоне, у Linux нет: новые заказы и звонки получает только запущенное приложение. Поэтому программы живут в трее и стартуют при входе в систему — не выходите из них через «Выйти», если ждёте звонков или заказов.
- Cenaly Phone: мастер настройки АТС, настройки и команда открываются в браузере (админка), а не внутри программы. Медиаклавиши гарнитуры работают, а кнопка снятия трубки (HID-телефония) пока не поддерживается — отвечайте кнопкой в окне или в уведомлении.
- Cenaly POS сама с оборудованием не говорит — только через мост. Камера ПК как сканер штрихкодов не поддерживается; USB-сканер работает как клавиатура.
- Окна работают через X11; в сессии Wayland — через XWayland, который в Ubuntu включён по умолчанию.
Устранение неполадок#
| Симптом | Причина | Что сделать |
|---|---|---|
| Нет значка в трее | на рабочем столе нет области значков (AppIndicator) | в Ubuntu расширение включено по умолчанию; если выключали — gnome-extensions enable ubuntu-appindicators@ubuntu.com и перезайдите. Без трея «закрыть» сворачивает окно в панель задач — звонки и заказы не теряются |
| Окно не открывается в сессии Wayland | нет XWayland | sudo apt install xwayland и перезайдите в систему |
| Нет звука звонка или микрофона (Phone), молчит звонок нового заказа (KDS) | звук идёт в другое устройство PipeWire | «Настройки» → «Звук»: выберите гарнитуру для вывода и ввода; проверка — wpctl status |
| Phone: «песочница Chromium недоступна» | на 24.04+ не загружен профиль AppArmor пакета | sudo apparmor_parser -r /etc/apparmor.d/cenaly-phone или sudo apt install --reinstall cenaly-phone. Не запускайте с --no-sandbox |
apt update: NO_PUBKEY или «не подписан» |
ключ репозитория удалён | однострочник с --repo-only: curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- --repo-only |
Unable to locate package cenaly-kds |
репозиторий не подключён | тот же --repo-only, затем sudo apt update |
Двойной щелчок по .deb открывает архиватор |
файл связан не с App Center | правой кнопкой → «Открыть с помощью» → App Center, или sudo apt install ./файл.deb |
Частые вопросы#
Чем пакет для Ubuntu отличается от Android-приложения?#
Это та же программа по составу экранов и действий, но для ПК: мышь и клавиатура, сенсорный экран для кассы и кухни, трей, уведомления рабочего стола. Аккаунт, точки и данные — общие.
Подойдёт ли Linux Mint, Debian или Pop!_OS?#
Мы проверяем установку на Ubuntu 22.04, 24.04 и 26.04 LTS. Системы на той же базе (Linux Mint 21–22, Pop!_OS 22.04–24.04) обычно ставят пакет так же, но мы их не проверяем.
Нужен ли интернет для установки?#
Для sudo apt install ./файл.deb — да, apt докачает системные библиотеки, если их нет. Сам пакет программы скачивается целиком, отдельная установка .NET не нужна.
Как поставить на много ПК сразу?#
Однострочником по SSH или своей системой управления (Ansible и т. п.): apt install cenaly-kds после подключения репозитория (--repo-only).
Связанные разделы#
- Мобильные приложения — Android-версии тех же программ
- Cenaly Hardware Bridge — мост оборудования
- Оборудование: что подключается
- Кухня (KDS) · Касса (POS) · Телефония: своя АТС