Skip to content
v26.3

Troubleshooting

Here you will find solutions for common problems.

Login

"Username or password incorrect"

  • Default login: admin / admin (after fresh installation)
  • Forgotten password: Database reset or restore from backup
  • Caps Lock: Check whether Caps Lock is active

"Connection to server failed"

  • Is the server reachable? Test: http://[Server-IP]:5015/healthz
  • Firewall rules: Port 5015 must be open
  • Docker: Is the container running? Check with docker ps

Printers

Receipt printer does not print

  1. Check network: Is the printer reachable? ping [Printer-IP]
  2. Check port: Default ESC/POS port is 9100
  3. Printer test: Admin → Settings → Printers → "Test Page"
  4. Cable connection: Check RJ45 cable on the printer

Kitchen printer prints wrong articles

Check the printer assignment: - Admin → Articles → Article group → Printer options - Is the correct group assigned to the correct printer?

Cash drawer does not open

The cash drawer is controlled via the receipt printer (RJ11 cable): 1. Check cable from printer to drawer 2. Admin → Settings → Printers → Enable "Open cash drawer on payment"

Debit Card Terminal

Terminal does not respond

  1. Check connection: ping [Terminal-IP]
  2. Check port: Default ZVT port is 20007
  3. Restart terminal: Turn off and on again
  4. Check settings: Admin → Settings → ZVT → IP and Port

"Terminal reports error"

  • Timeout: Connection too slow → increase timeout in settings
  • Amount 0: Acquirer's minimum amount not reached
  • Card declined: Bank issue, not DiKAS

Tables

Table cannot be closed

  • Check whether all items have been paid
  • Open orders must first be checked out or voided

Table is permanently red (occupied)

  • Possibly open orders from a crashed process
  • Admin → Cash book → Check open orders for the table and void if necessary

Database

"CouchDB not reachable"

  1. Is CouchDB running? docker ps or systemctl status couchdb
  2. URL correct? Access http://localhost:5984 → should show JSON
  3. Credentials correct?

Database is full

  • CouchDB: Perform compaction → Admin → System → "Compact Database"
  • SQLite: Check file size, archive old end-of-day reports

Performance

System is slow

  • Too many articles? Deactivate inactive articles instead of loading all
  • Old data: Archive data older than 2 years
  • Server resources: Check RAM and CPU (at least 4 GB RAM recommended)
  • Browser cache: Clear the browser cache (Ctrl+Shift+Delete)

Kitchen display reacts with delay

  • Check SignalR connection: Browser console (F12) → Network tab → WebSocket connection
  • Check Wi-Fi signal at the kitchen screen
  • Use an Ethernet cable instead of Wi-Fi

Backup & Restore

Backup file is corrupted

  • Test the ZIP file with an archive program
  • Create a new backup and compare
  • CouchDB: Back up directly via CouchDB replication

Restore aborts

  • Is there enough storage space?
  • Is the server version compatible with the backup?
  • Try a selective restore (only specific categories)

Contact & Support

If you cannot resolve the issue: - Email: support@dikas.de - Phone: (See your contract) - Remote support: Schedule a TeamViewer/AnyDesk session