Hisaab Docs Support Download

Docs / Troubleshooting

Fix common problems

Find the cause and the fix for the messages and situations users meet most often.

TroubleshootingHisaab 0.6Updated 19 November 2026

Most problems show a message in the status bar at the bottom of the window. Find the message or situation below.

Opening a company#

"The books are busy (another user is saving)"#

Cause: Someone else was saving in the same company folder and the save took more than 20 seconds.

Fix: Try again in a moment. A lock left by a crashed program is cleared automatically after 90 seconds. You do not need to delete any file.

"Hisaab opened the sample company instead of mine"#

Cause: Your last company could not be opened. The status bar gives the reason, followed by "showing the sample company".

Fix: Press F3 and click your company under Your companies. If it is encrypted, type the passphrase and click Unlock.

"After a power cut it says 'discarded an incomplete final journal entry'"#

Cause: The computer stopped while a change was being written. Hisaab found the half-written line by its checksum and dropped it.

Fix: Nothing is damaged. Check whether the last voucher you entered is there, and enter it again if not.

"The top bar says read-only" or "journal is damaged … restore a backup"#

Cause: A line in the middle of journal.log fails its checksum, so the file was changed or damaged outside the app. You can view the books but not change them.

Fix:

  1. Open Settings, then Backups.
  2. Click Restore beside the newest backup from before the problem. Admin access is needed.
  3. Re-enter anything recorded after that backup.

Passwords#

"I forgot the company passphrase"#

This applies to an encrypted company. The passphrase is never stored and there is no reset. Changing the passphrase also needs the current one. Without it nobody can read the books. Backups inside the company folder are encrypted with the same passphrase. Only an export or a copy of the folder made before encryption was switched on can still be opened.

"I forgot my user password"#

Ask an Admin to open Settings, then Users & access, type your user name with a new password and click Save user. This replaces your password.

If the only Admin has forgotten the password, there is no reset in the app.

Import#

"This file is not XML" or "this file is not text"#

Cause: The file is not a legacy XML export, CSV or .xlsx.

Fix: Export from your previous software again in XML format, or use a sheet.

"The column headings in row 1 were not recognised"#

Cause: The sheet's headings do not match the ledgers, stock items or vouchers layout.

Fix: On Import & Export, click ledgers, stock items or vouchers beside Blank sheets to fill in, and put your data under those headings.

"Row 14: … does not balance" and other row messages#

Cause: A row has a wrong date, amount or Dr/Cr, or a voucher's debits and credits differ. Nothing from that sheet was imported.

Fix: Correct the rows named in the message and import again.

"This screen reads a bank statement (CSV or Excel), not a picture"#

Cause: A picture was dropped on the Bank Reconciliation screen. That screen takes a statement file.

Fix: Drop the bank's CSV or .xlsx statement there. To scan a bill picture, press F10 for the Day Book and drop the picture on it.

"Open the Day Book to scan a bill picture"#

Cause: A picture was dropped on a screen that does not scan bills.

Fix: Press F10 and drop the picture on the Day Book. The Purchase register, a voucher and the voucher form take bill pictures too.

Vouchers and backups#

"… is cancelled and cannot be altered"#

Cause: A cancelled voucher stays cancelled. It only holds its number.

Fix: Open the voucher, click Duplicate and save the copy as a new voucher.

"Accountant access is required to take a backup"#

Cause: You are signed in as a Viewer. Back up now needs Accountant or Admin access, here and on the cloud screen.

Fix: Ask an Accountant or Admin to take the backup. The automatic daily backup is still taken when the company is opened.

"The stock went down twice for one sale"#

Cause: A Delivery Note and a Sales invoice were entered for the same goods without a link. The same happens with a Receipt Note and a Purchase.

Fix: Open the invoice, click Alter, type the note's number in Against order no. and save. See Voucher types.

"The current passphrase is not right — nothing was changed"#

Cause: The passphrase typed in current passphrase is not the one that opens this company.

Fix: Type it again. If it is forgotten, see the next section.

AI assistant#

"The assistant does not answer"#

  1. If the status bar says "set up a model in AI Settings first", open AI Settings, fill Base URL and Model, add the API key if your service needs one, and click Save settings.
  2. Click Test connection. A working service shows "connected" with the number of models.
  3. If the reply starts with "Could not get an answer", the text after it comes from your AI provider, for example a wrong key or an unknown model name.

Hisaab does not include an AI service. You bring your own.

Updates#

"Could not reach …" or "… took too long to answer"#

Cause: The Hisaab website did not answer the check for updates. The computer may be offline, or a firewall or proxy may be blocking the app.

Fix: Check the internet connection and click Check again. If your browser can open the website named in the message but Hisaab cannot, download the installer from the website's downloads page instead.

"… does not have that file" or "… sent the request on to another address"#

Cause: The address under Website in Settings is not the Hisaab website, or the website is being updated.

Fix: Open Settings. Under Website, clear Website address and click Save so the automatic address is used, then check again. See Where your data lives.

"The downloaded file does not match the checksum … so it was deleted"#

Cause: The file that arrived is not the one the website lists. Usually the download was damaged on the way.

Fix: Click Try again. If it happens twice, do not use a copy from elsewhere: use Report a problem on the About screen. See Update Hisaab.

"This release has no download for this computer"#

Cause: The newer version was not published for your kind of computer, or not in the form your copy was installed from.

Fix: Click Open the downloads page and pick a file by hand. Install Hisaab lists which file suits which computer.

"Hisaab closed unexpectedly last time"#

Cause: The program stopped without being asked to. Your books are safe: every change was already written before it stopped.

Fix: Nothing is needed. If you remember what you were doing, open About and click Report a problem. See What Hisaab sends for what the report file holds.

Starting the app#

"The app does not start on Linux"#

Cause: With the AppImage or .tar.gz, a system library is missing. These two downloads do not carry libraries.

Fix: Install libxkbcommon0, libwayland-client0, libgl1 or libegl1, and libfontconfig1. The .deb package pulls these in for you.

Next#

Something here wrong or missing? Open a ticket and mention this page.

Hisaab is developed and supported by Aware Consultants  ·  About  ·  Support  ·  Privacy