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.
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 examplebackups/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 insidecompanies/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:
- Open Settings.
- Under Website, type the address in Website address, for example
https://hisaab.example.com. - 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_URLis 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_DIRbefore starting Hisaab.
Next#
- Back up and restore
- Lock a company with a password
- What Hisaab sends, and how to switch it off
- Fix common problems
Something here wrong or missing? Open a ticket and mention this page.
