Hisaab Docs Support Download

Docs / Reference

Where your data lives

Find the data folder on your computer, understand each file in a company folder and know what is safe to copy.

ReferenceHisaab 0.6Updated 19 November 2026

Hisaab keeps settings, companies and exports in one data folder. Each company is its own folder inside it.

The data folder#

Hisaab picks the folder in this order and uses the first one that applies:

Order Condition Folder
1 The HISAAB_CONFIG_DIR environment variable is set That folder
2 APPDATA is set (normal on Windows) %APPDATA%\Hisaab
3 XDG_CONFIG_HOME is set (some Linux systems) $XDG_CONFIG_HOME/hisaab
4 Otherwise (macOS and most Linux) ~/.config/hisaab

On macOS the folder is ~/.config/hisaab, not a folder under Library.

Inside the data folder:

Item What it is
config.json Settings for this computer: theme, last company opened, the shared folder and its unlock code if used, AI assistant and cloud backup addresses and keys, the website address, whether to check for updates at start, and your answers about sharing
companies/ One folder per company kept on this computer
moved/ Present only after a company was moved to a shared folder: the folder it came from, kept as it was
exports/ Every exported or printed file
crashes/ Present only after Hisaab has stopped unexpectedly: up to 5 small report files. See What Hisaab sends

Careful: config.json can hold your AI and cloud keys in readable form. Do not send this file to anyone.

A company folder#

A company folder is named after the company, for example companies/acme-traders. The About screen shows the exact path as Data folder.

File What it is for
journal.log The books. One line is added for every change, with a checksum. Lines are never rewritten. This is also the edit log
snapshot.json A checkpoint of the current state so the company opens quickly. It is rebuilt from the journal if it is missing or does not match
company.json The company name, so the list of companies can be shown without opening the books
backups/ Backups, one folder per backup
vault.json Present only for an encrypted company. Holds what is needed to check the passphrase. It does not hold the passphrase or a key
.lock A short-lived file that exists only while someone is saving

In an encrypted company, journal.log and snapshot.json cannot be read without the passphrase. company.json stays readable, so the company name is not secret.

Backups#

Each backup is a folder inside backups/, named with its date and time, for example backups/20261119-062156. It holds copies of the company's files.

  • A backup is taken once a day when you open the company. The newest 14 automatic backups are kept.
  • Back up now on the Backups screen takes one at any time. Its folder name ends in -manual, for example backups/20261119-101500-manual, and it is never removed automatically.
  • Backups of an encrypted company are encrypted too.

Backups sit on the same disk as the books. Copy the company folder elsewhere as well.

The lock file#

Several people can open the same company folder at once from a shared drive. To set that up, see Work together from several computers. There is no "company in use" lock that keeps others out. Each save creates .lock for a moment and then removes it.

If the app says "the books are busy (another user is saving)", another save held the lock for more than 20 seconds. Wait and try again. A lock left behind by a crash is cleared automatically once it is 90 seconds old. You do not need to delete it yourself.

What is safe to copy#

  • To move or keep a company: close Hisaab, then copy the whole company folder, including backups/. Put it inside companies/ on the other computer and it appears on the Company screen (F3).
  • Do not copy single files out of a company folder, edit journal.log, or rename files inside it. A changed journal line fails its checksum and the company opens read-only.

Files in exports/ are copies. You can delete them.

The website address#

Updates, the support form and anything you agreed to share all use one website address. Settings shows it under Website, as In use, with the reason beside it.

Hisaab picks the address in this order and uses the first one that applies:

Order Source Settings shows
1 The HISAAB_SITE_URL environment variable is set set by HISAAB_SITE_URL
2 You typed an address in Website address set here
3 The website announced that it has moved the website moved
4 Otherwise, the address this version was made with automatic

Leave Website address blank unless you were given another address. To set one:

  1. Open Settings.
  2. Under Website, type the address in Website address, for example https://hisaab.example.com.
  3. Click Save, or press Enter.

The address must start with https:// and end at the website's name: no page, no question mark, no user name. Anything else is refused with the reason, and the address in use stays as it was. To go back to automatic, clear the field and click Save.

When the website moves#

If the website gets a new address, the old address says so. On the next check for updates Hisaab goes to the new address, remembers it, and shows the website moved beside it.

What Hisaab remembers is never final. Every check for updates starts at the automatic address again, the one this version was made with, and does what that address says now:

The automatic address What Hisaab does
Says the website has moved Uses the new address for this check and remembers it
Answers, and no longer says the website has moved Forgets the remembered address and uses the automatic one
Cannot be reached at all Uses the remembered address, if there is one, and says so beside the answer

So a move that was announced by mistake, or by someone who should not have, lasts only until it is taken back. The next check goes back to the automatic address by itself.

The box for a newer version always says in a full sentence which website the update comes from and why, for example "This update comes from new.example.com. The website at old.example.com said it had moved there." Read it before you download. The new website supplies both the file and the checksum it is checked against, so download only if you trust that name.

  • Hisaab follows one move per check, never a chain of them.
  • A new address must start with https://. Anything else is ignored.
  • A move is followed only from the automatic address. If you set the address yourself, or HISAAB_SITE_URL is set, Hisaab stays with it and tells you where the website says it went.
  • Usage statistics and crash reports never follow a move by themselves. They go to the address shown as In use, and to no other.
  • Forget and use the automatic address drops what was remembered at once.
  • Saving another address, or Forget, stops a check or a download that is still running. Its result is not used.

Limits#

  • The Company screen lists only companies inside companies/. There is no button to open a folder from another place.
  • There is no setting in the app to move the data folder. To use a different folder, set HISAAB_CONFIG_DIR before starting Hisaab.

Next#

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

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