Cenaly uygulamalarını Ubuntu’ya kurma

İşletmelerin çalışma yerleri çoğu zaman Linux’ta çalışır: tezgâhtaki kasa, mutfaktaki ya da sipariş hazırlama alanındaki ekran, kulaklıklı operatör bilgisayarı. Bunlar için Cenaly’nin Ubuntu için yerel programları var — yönetim panelindeki ve Android uygulamalarındaki aynı hesap, aynı şubeler ve veriler. Her işletmeye uygundur: kafe ve restoran, mağaza, salon, otel, teslim noktası.

Başlamak için gerekenler#

Ne	Gereksinim
Sistem	Ubuntu 22.04, 24.04 veya 26.04 LTS (GNOME masaüstü; aynı tabandaki Kubuntu, Xubuntu ve diğer sürümler de)
İşlemci	amd64 — Intel ve AMD’li sıradan masaüstü ve dizüstü bilgisayarlar; arm64 — ARM bilgisayarlar
Yetki	paketi kurmak için yönetici parolası (`sudo`)
Hesap	Cenaly yönetim panelindeki aynı e-posta ve parolayla giriş (sahip ya da bölüme erişimi olan çalışan)
Ağ	giriş ve çalışma için internet (veriler Cenaly bulutundadır)

Bilgisayarınızın mimarisini öğrenmek için "Terminal"i açın ve dpkg --print-architecture çalıştırın — yanıt amd64 ya da arm64 olur.

Hangi uygulamalar var#

Uygulama	Paket	Kimin için
Cenaly Phone	`cenaly-phone`	operatör, yönetici, resepsiyon: işletme santrali üzerinden aramalar, kuyruk, aktarma, geçmiş
Cenaly KDS	`cenaly-kds`	mutfak, bar, sipariş hazırlama ve teslim: istasyonlara göre fişler, zamanlayıcılar, "Hazır" ve "Teslim edildi"
Cenaly POS	`cenaly-pos`	kasa: satış, ödeme, fiş, iade; donanım — köprü üzerinden
Cenaly Hardware Bridge	`cenaly-bridge`	arka plan hizmeti: fiş ve mutfak yazıcıları, yazar kasalar, teraziler, okuyucular, para çekmecesi

Programlar birbirine bağlı değildir: yalnızca gerekenleri kurun. Yazıcısı ya da yazar kasası olan bir kasaya köprü de gerekir — aynı bilgisayarda ya da şubenin başka bir bilgisayarında.

Adım 1. Paketi indirin#

Sitede uygulamanın sayfasını açın — örneğin "Uygulamalar" bölümünde "Cenaly KDS".
Ubuntu bloğunda mimarinize uygun düğmeye basın: .deb · amd64 ya da .deb · arm64. Tarayıcı mimariyi bildirirse doğru düğme önce gelir.
cenaly-kds_1.0.0_amd64.deb gibi bir dosya "İndirilenler" klasörüne kaydedilir.

Düğme her zaman yayınlanmış son sürüme götürür.

Adım 2. Kurun#

Çift tıklamayla. "İndirilenler"i açın ve .deb dosyasına çift tıklayın — App Center açılır (22.04’te "Ubuntu Software"). **"Yükle"**ye basın ve yönetici parolasını girin.

Komutla. "Terminal"de, dosyanın bulunduğu klasörde:

cd ~/İndirilenler   # ya da ~/Downloads
sudo apt install ./cenaly-kds_*_amd64.deb

apt gerekli sistem kitaplıklarını kendisi getirir. Nokta ve eğik çizgi ./ zorunludur — onlar olmadan apt klasördeki dosya yerine paketi internette arar.

Terminalden kurulum#

Sunucular, kiosklar ve SSH ile uzaktan kurulum için tek satırlık bir komut vardır: Cenaly deposunu ekler (imza anahtarı parmak iziyle doğrulanır) ve uygulamayı apt ile kurar.

Hesabın bulunduğu yer	Komut
cenaly.com ve diğer marka alan adları	`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 yerine phone, pos ya da bridge; boşlukla ayrılmış birkaç tane de olur: … -- kds pos. Uygulama sayfası markanıza uygun hazır komutu "Kopyala" düğmesiyle gösterir.

Adım 3. İlk açılış ve giriş#

Ubuntu uygulama menüsünü açın ve Cenaly KDS’i (Phone, POS) bulun.
Cenaly hesabınızın e-posta ve parolasıyla ya da cihaz koduyla giriş yapın — Android uygulamasındaki gibi.
Şubeyi seçin. Uygulama bundan sonra girişi hatırlar: oturum düz bir dosyada değil, sistem anahtarlığında (GNOME Keyring) saklanır.

Phone, KDS ve POS sistem tepsisinde yaşar ve oturum açılınca başlar — böylece mutfak ekranı sipariş, telefon da arama kaçırmaz. Otomatik başlatma tepsi simgesinin menüsünden kapatılır.

Güncellemeler#

Paket kurulurken kendi markasının Cenaly deposunu ekler (/etc/apt/sources.list.d/cenaly.sources, Cenaly anahtarıyla imzalı). Yeni sürümler Ubuntu’nun olağan güncellemeleriyle gelir — "Yazılım Güncelleyici"de ya da şu komutla:

sudo apt update && sudo apt upgrade

Dosyayı siteden yeniden indirmeniz gerekmez. Politikanız üçüncü taraf depoları yasaklıyorsa kurmadan önce CENALY_APT_REPO=off satırını içeren /etc/default/cenaly dosyasını oluşturun — o zaman siteden yeni .deb ile elle güncellersiniz.

Kaldırma#

sudo apt remove cenaly-kds      # programı kaldır, sistem ayarlarını bırak
sudo apt purge cenaly-kds       # sistem ayarlarıyla birlikte kaldır

Bilgisayardaki son Cenaly paketinin purge ile kaldırılması depoyu ve anahtarı da siler. Uygulamanın kişisel verileri (önbellek, seçilen şube) ev klasöründedir — ~/.local/share/cenaly/<uygulama>; bilgisayarı başka birine veriyorsanız silin. Tek satırlık komut da aynı işi yapar: curl -fsSL https://cdn.cenaly.com/linux/install.sh | sudo bash -s -- remove kds.

Snap Store#

Dört programın snap sürümleri Snap Store için hazırlanıyor. Yayınlandıklarında uygulama sayfasında Snap Store düğmesi çıkar, kurulum ise sudo snap install cenaly-kds olur. USB-COM üzerinden yazar kasası ya da terazisi olan bir kasa için .deb alın: Ubuntu kurallarına göre snap COM bağlantı noktalarını görmez.

Ubuntu’da donanım köprüsü#

Cenaly Hardware Bridge Ubuntu’da bir sistem hizmetidir: bilgisayar açılınca başlar ve kendini yeniden başlatır. cenaly-bridge paketini kurduktan sonra http://127.0.0.1:9100 durum sayfasını açın (menüdeki "Cenaly Hardware Bridge" kısayolu) ve köprüyü şubeye bağlayın — ayrıntılar Cenaly Hardware Bridge makalesinde. Köprü daha önce "Donanım" sayfasındaki eski tek satırlık komutla kurulduysa paket ayarlarını ve bağlantısını devralır — tek hizmet kalır.

Sınırlamalar#

Linux’ta telefondaki gibi anlık bildirim yoktur: yeni siparişler ve aramalar yalnızca çalışan uygulamaya ulaşır. Bu yüzden programlar tepside yaşar ve oturum açılınca başlar — arama ya da sipariş bekliyorsanız "Çıkış" ile kapatmayın.
Cenaly Phone: santral kurulum sihirbazı, ayarlar ve ekip programın içinde değil, tarayıcıda (yönetim panelinde) açılır. Kulaklığın medya tuşları çalışır, ancak ahize düğmesi (HID telefon) henüz desteklenmiyor — pencerede ya da bildirimdeki düğmeyle yanıtlayın.
Cenaly POS donanımla kendisi konuşmaz — yalnızca köprü üzerinden. Bilgisayar kamerası barkod okuyucu olarak desteklenmez; USB okuyucu klavye gibi çalışır.
Pencereler X11’de çalışır; Wayland oturumunda — Ubuntu’da varsayılan olarak açık olan XWayland üzerinden.

Sorun giderme#

Belirti	Neden	Ne yapmalı
Tepside simge yok	masaüstünde simge alanı (AppIndicator) yok	Ubuntu’da eklenti varsayılan olarak açıktır; kapatıldıysa — `gnome-extensions enable ubuntu-appindicators@ubuntu.com` ve yeniden oturum açın. Tepsi olmadan "kapat" pencereyi görev çubuğuna küçültür — aramalar ve siparişler kaybolmaz
Pencere Wayland oturumunda açılmıyor	XWayland yok	`sudo apt install xwayland` ve yeniden oturum açın
Arama sesi ya da mikrofon yok (Phone), yeni sipariş zili sessiz (KDS)	ses başka bir PipeWire aygıtına gidiyor	"Ayarlar" → "Ses": çıkış ve giriş için kulaklığı seçin; kontrol — `wpctl status`
Phone: "Chromium korumalı alanı kullanılamıyor"	24.04+’da paketin AppArmor profili yüklenmemiş	`sudo apparmor_parser -r /etc/apparmor.d/cenaly-phone` ya da `sudo apt install --reinstall cenaly-phone`. `--no-sandbox` ile çalıştırmayın
`apt update`: `NO_PUBKEY` ya da "imzalı değil"	depo anahtarı silinmiş	`--repo-only` ile tek satırlık komut: `curl -fsSL https://cdn.cenaly.com/linux/install.sh \| sudo bash -s -- --repo-only`
`Unable to locate package cenaly-kds`	depo eklenmemiş	aynı `--repo-only`, ardından `sudo apt update`
`.deb` dosyasına çift tıklama arşiv yöneticisini açıyor	dosya App Center ile ilişkilendirilmemiş	sağ tık → "Birlikte aç" → App Center ya da `sudo apt install ./dosya.deb`

Sık sorulan sorular#

Ubuntu paketi Android uygulamasından nasıl farklı?#

Ekranlar ve işlemler bakımından aynı programdır, ama bilgisayar için: fare ve klavye, kasa ve mutfak için dokunmatik ekran, tepsi, masaüstü bildirimleri. Hesap, şubeler ve veriler ortaktır.

Linux Mint, Debian ya da Pop!_OS olur mu?#

Kurulumu Ubuntu 22.04, 24.04 ve 26.04 LTS’de test ediyoruz. Aynı tabandaki sistemler (Linux Mint 21–22, Pop!_OS 22.04–24.04) paketi genellikle aynı şekilde kurar, ama onları test etmiyoruz.

Kurulum için internet gerekli mi?#

sudo apt install ./dosya.deb için — evet, eksikse apt sistem kitaplıklarını indirir. Programın paketi eksiksizdir; ayrıca .NET kurmak gerekmez.

Birçok bilgisayara aynı anda nasıl kurulur?#

SSH üzerinden tek satırlık komutla ya da kendi yönetim sisteminizle (Ansible vb.): depoyu ekledikten sonra (--repo-only) apt install cenaly-kds.

İlgili bölümler#

Mobil uygulamalar — aynı programların Android sürümleri
Cenaly Hardware Bridge — donanım köprüsü
Donanım: neler bağlanır
Mutfak (KDS) · Kasa (POS) · Telefon: kendi santraliniz