PID File

For reliability and to avoid certain race conditions or deadlocks (for example during database migration), nzyme needs to know if another instance is already running on the same host.

It does so by managing a PID file at /tmp/nzyme-node.pid. The nzyme-node start up procedure will abort and exit if it determines that another nzyme-node is already running on the same machine.

Running Multiple nzyme-node On The Same Host

You can skip the PID file check by passing the --no-pid-check flag. This is only recommended for advanced users who understand the potential failure modes of running multiple nzyme-node instances on the same host.