FerryDocs
ConceptsSelf-healing

One server for each data directory

Two protections make sure that only one server controls a set of resources.

Edit on GitHub
ferryd Arunsferryd BData directoryferryd.lockContainersprefix: ferry

ferryd A locks its data directory. It owns the containers with the prefix ferry.

1 / 3

The lock of the data directory

While it runs, ferryd holds an exclusive lock on <data-dir>/ferryd.lock. A second server with the same refuses to start.

Error
Error: another ferryd is already running with data directory /var/lib/ferry

The owner of the name prefix

All Docker resources of a server have its : --name-prefix, default ferry. One prefix has one data directory as its owner.

Error
Error: Docker resources with prefix 'ferry' belong to another Ferry server (data dir /var/lib/ferry). Run this server with a different --name-prefix, stop the other server, or pass --take-over to adopt the resources (the other server's containers will then be managed — and possibly removed — by this one).

--take-over

Use --take-over only if you want this server to control the resources. An example: you restored a data directory without its instance_id file.

On this page