oci-register-machine man page

oci-register-machine — Register OCI containers with systemd-machined


oci-register-machine is a OCI hook program. If you add it to the runc json data as a hook, runc will execute the application after the container process is created but before it is executed, with a prestart flag. When the container exits oci-register-machine will be executed, after the container exits but before it is destroyed, with the poststop flag. Docker will execute oci-register-machine as a container hook when it is installed in the /usr/libexec/oci/hooks.d directory.

After starting an OCI container, the container will be listed with the machinectl. The machine name will be the container ID. Machinectl will then be able to manage the container. When container exits, the oci-register-machine will remove the instance from machinectl.

You can disable this service by editing the /etc/oci-register-machine.conf file and setting the disabled field to true.


$ docker run --it busybox /bin/sh

(In different terminal):

$ machinectl
MACHINE                          CLASS     SERVICE
5556287c7fa1c2312243f5ca2d75c90b container docker 

1 machines listed.

See Also

docker-run(1), machinectl(1), systemd-machined(8)


November 2015, updated by Sally O'Malley ⟨somalley@redhat.com⟩


Explore man page connections for oci-register-machine(1).