Set up a printer
Connect a receipt printer over the network or a Print Agent, and configure printing options from the admin panel.
August 23, 2026
This article covers connecting a receipt printer and configuring printing options from the "الطباعة" (Printing) tab in POS settings.
Steps
- 1Open "إعدادات نقطة البيع" (POS settings, /admin/pos) and choose the "الطباعة" (Printing) tab.
- 2If you have a Print Agent running on the network, it will be auto-discovered under "Print Agents المكتشفة تلقائياً" — click "استخدام" (Use) to link it directly.
- 3To configure manually, enable "تفعيل الطباعة عبر الشبكة" (Enable network printing) under "إعدادات الطابعة عبر IP" (Printer IP settings).
- 4Enter the printer's IP address (e.g. 192.168.1.100) and port (usually 9100), or the Print Agent HTTPS URL if you're using one.
- 5Click "🖨 اختبار الطابعة" (Test printer) to confirm the connection works.
- 6Set paper width (58mm or 80mm) and auto-cut according to your printer.
- 7Enable "فتح درج النقد عند الدفع النقدي" (Open cash drawer on cash payment) if you have a drawer connected to the printer.
- 8Click "حفظ" (Save) at the bottom of the page to save all settings.
The "🖨 اختبار الطابعة" (Test printer) button stays disabled until an IP address is entered.
How to verify
Click "🔍 فحص" (Check) next to the added printer — its status should change to "✅ متصل" (Connected).
Common errors
Problem
The printer status shows "❌ لا يرد" (Not responding) after a check.
Solution
Confirm the printer and device are on the same network, the IP address and port are correct, and the printer is powered on.
Was this article helpful?