.TH "podman-varlink" "1" "" 
.nh
.ad l

.SH NAME
.PP
podman\-varlink \- Runs the varlink backend interface

.SH SYNOPSIS
.PP
\fBpodman varlink\fP [\fIoptions\fP] \fIuri\fP

.SH DESCRIPTION
.PP
Starts the varlink service listening on \fIuri\fP that allows varlink clients to interact with podman.  If no \fIuri\fP is provided, a default
URI will be used depending on the user calling the varlink service.  The default for the root user is \fB\fCunix:/run/podman/io.podman\fR\&. Regular
users will have a default \fIuri\fP of \fB\fC$XDG\_RUNTIME\_DIR/podman/io.podman\fR\&.  For example, \fB\fCunix:/run/user/1000/podman/io.podman\fR
The varlink service should generally be done with systemd.  See \fIConfiguration\fP below.

.SH OPTIONS
.PP
\fB\-\-help\fP, \fB\-h\fP

.PP
Print usage statement

.PP
\fB\-\-timeout\fP, \fB\-t\fP

.PP
The time until the varlink session expires in \fImilliseconds\fP\&. The default is 1
second. A value of \fB\fC0\fR means no timeout and the session will not expire.

.SH EXAMPLES
.PP
Run the podman varlink service accepting all default options.

.PP
.RS

.nf
$ podman varlink

.fi
.RE

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

.PP
.RS

.nf
$ podman varlink unix:/tmp/io.podman

.fi
.RE

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

.PP
.RS

.nf
$ podman varlink \-\-timeout 5000

.fi
.RE

.SH CONFIGURATION
.PP
Users of the podman varlink service should enable the \fIio.podman.socket\fP and \fIio.podman.service\fP\&.
This is the preferred method for running the varlink service.

.PP
You can do this via systemctl.

.PP
.RS

.nf
$ systemctl enable \-\-now io.podman.socket

.fi
.RE

.SH SEE ALSO
.PP
podman(1), systemctl(1)

.SH HISTORY
.PP
April 2018, Originally compiled by Brent Baude
\[la]bbaude@redhat.com\[ra]