2023-09-11 00:13:51 -04:00
# Troubleshooting
## What to do if a binary cache is down or unreachable?
2023-09-11 05:44:33 -04:00
Pass [`--option substitute false` ](https://nixos.org/manual/nix/stable/command-ref/conf-file#conf-substitute ) to Nix commands.
2023-09-11 00:13:51 -04:00
2023-09-11 05:44:33 -04:00
### How to fix: `error: querying path in database: database disk image is malformed`
2023-09-11 00:13:51 -04:00
2023-09-11 05:44:33 -04:00
This is a [known issue ](https://github.com/NixOS/nix/issues/1353 ).
2023-09-11 00:13:51 -04:00
Try:
```shell-session
$ sqlite3 /nix/var/nix/db/db.sqlite "pragma integrity_check"
```
2023-09-11 05:44:33 -04:00
Which will print the errors in the [database ](https://nixos.org/manual/nix/stable/glossary#gloss-nix-database ).
If the errors are due to missing references, the following may work:
2023-09-11 00:13:51 -04:00
```shell-session
$ mv /nix/var/nix/db/db.sqlite /nix/var/nix/db/db.sqlite-bkp
$ sqlite3 /nix/var/nix/db/db.sqlite-bkp ".dump" | sqlite3 /nix/var/nix/db/db.sqlite
```
2023-09-11 05:44:33 -04:00
### How to fix: `error: current Nix store schema is version 10, but I only support 7`
2023-09-11 00:13:51 -04:00
2023-09-11 05:44:33 -04:00
This is a [known issue ](https://github.com/NixOS/nix/issues/1251 ).
2023-09-11 00:13:51 -04:00
2023-09-11 05:44:33 -04:00
It means that using a new version of Nix upgraded the SQLite schema of the [database ](https://nixos.org/manual/nix/stable/glossary#gloss-nix-database ), and then you tried to use an older version Nix.
The solution is to dump the database, use the old Nix version to initialize it, and then re-import the data:
2023-09-11 00:13:51 -04:00
```shell-session
$ /path/to/nix/unstable/bin/nix-store --dump-db > /tmp/db.dump
$ mv /nix/var/nix/db /nix/var/nix/db.toonew
$ mkdir /nix/var/nix/db
$ nix-store --init # this is the old nix-store
$ nix-store --load-db < /tmp/db.dump
```
2023-09-11 05:44:33 -04:00
### How to fix: `writing to file: Connection reset by peer`
This may mean you are trying to import a too large file or directory into the [Nix store ](https://nixos.org/manual/nix/stable/glossary#gloss-store ), or your machine is running out of resources, such as disk space or memory.
2023-09-11 00:13:51 -04:00
2023-09-11 05:44:33 -04:00
Try to reduce the size of the directory to import, or run [garbage collection ](https://nixos.org/manual/nix/stable/command-ref/nix-collect-garbage ).