.nh
.TH podman\-service(1)
.SH NAME
.PP
podman\-system\-service \- Run an API service

.SH SYNOPSIS
.PP
\fBpodman system service\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
The \fBpodman system service\fP command creates a listening service that will answer API calls for Podman.  You may
optionally provide an endpoint for the API in URI form.  For example, \fIunix://tmp/foobar.sock\fP or \fItcp:localhost:8080\fP\&.
If no endpoint is provided, defaults will be used.  The default endpoint for a rootful
service is \fIunix:/run/podman/podman.sock\fP and rootless is \fIunix:/$XDG\_RUNTIME\_DIR/podman/podman.sock\fP (for
example \fIunix:/run/user/1000/podman/podman.sock\fP)

.PP
The REST API provided by \fBpodman system service\fP is split into two parts: a compatibility layer offering support for the Docker v1.40 API, and a Podman\-native Libpod layer.
Documentation for the latter is available at \fIhttps://docs.podman.io/en/latest/\_static/api.html\fP\&.
Both APIs are versioned, but the server will not reject requests with an unsupported version set.

.PP
Note: The default systemd unit files (system and user) change the log\-level option to \fIinfo\fP from \fIerror\fP\&. This change provides additional information on each API call.

.SH OPTIONS
.SS \fB\-\-time\fP, \fB\-t\fP
.PP
The time until the session expires in \fIseconds\fP\&. The default is 5
seconds. A value of \fB\fC0\fR means no timeout, therefore the session will not expire.

.SS \fB\-\-help\fP, \fB\-h\fP
.PP
Print usage statement.

.SH EXAMPLES
.PP
Run an API listening for 5 seconds using the default socket.

.PP
.RS

.nf
podman system service \-\-timeout 5000

.fi
.RE

.SH SEE ALSO
.PP
podman(1), podman\-system\-service(1), podman\-system\-connection(1)

.SH HISTORY
.PP
January 2020, Originally compiled by Brent Baudebbaude@redhat.com
\[la]mailto:bbaude@redhat.com\[ra]
November 2020, Updated by Jhon Honce