NAME¶

podman-varlink - Runs the varlink backend interface

SYNOPSIS¶

podman varlink [options] uri

DESCRIPTION¶

Starts the varlink service listening on uri that allows varlink clients to interact with podman. If no uri is provided, a default URI will be used depending on the user calling the varlink service. The default for the root user is unix:/run/podman/io.podman. Regular users will have a default uri of $XDG_RUNTIME_DIR/podman/io.podman. For example, unix:/run/user/1000/podman/io.podman The varlink service should generally be done with systemd. See Configuration below.

OPTIONS¶

--help, -h

Print usage statement

--timeout, -t

The time until the varlink session expires in milliseconds. The default is 1 second. A value of 0 means no timeout and the session will not expire.

EXAMPLES¶

Run the podman varlink service accepting all default options.

$ podman varlink

Run the podman varlink service with an alternate URI and accept the default timeout.

$ podman varlink unix:/tmp/io.podman

Run the podman varlink service manually with a 5 second timeout.

$ podman varlink --timeout 5000

CONFIGURATION¶

Users of the podman varlink service should enable the io.podman.socket and io.podman.service. This is the preferred method for running the varlink service.

You can do this via systemctl.

$ systemctl enable --now io.podman.socket

SEE ALSO¶

podman(1), systemctl(1)

HISTORY¶

April 2018, Originally compiled by Brent Baude ⟨bbaude@redhat.com⟩