NAME

       podman-system-service - Run an API service

SYNOPSIS

       podman system service [options]

DESCRIPTION

       The podman system service 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, unix:///tmp/foobar.sock or
       tcp:localhost:8080.  If no endpoint is provided, defaults will be  used.   The  default  endpoint  for  a
       rootfull        service        is        unix:///run/podman/podman.sock       and       rootless       is
       unix://$XDG_RUNTIME_DIR/podman/podman.sock (for example unix:///run/user/1000/podman/podman.sock)

       To access the API service inside a container: - mount the socket as a volume -  run  the  container  with
       --security-opt label:disable

       The  REST  API  provided by podman system service 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 https://docs.podman.io/en/latest/_static/api.html.  Both APIs are versioned, but the server
       will not reject requests with an unsupported version set.

       Note: The default systemd unit files (system and user) change the log-level option to  info  from  error.
       This change provides additional information on each API call.

OPTIONS

   --time, -t
       The  time  until the session expires in seconds. The default is 5 seconds. A value of 0 means no timeout,
       therefore the session will not expire.

   --cors
       CORS headers to inject to the HTTP response. The default  value  is  empty  string  which  disables  CORS
       headers.

   --help, -h
       Print usage statement.

EXAMPLES

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

              podman system service --time 5

SEE ALSO

       podman(1), podman-system-service(1), podman-system-connection(1)

HISTORY

       January 2020, Originally compiled by Brent Baude <bbaude@redhat.com> November 2020, Updated by Jhon Honce
       (jhonce at redhat dot com)

                                                                                             podman-service(1)()