1podman-service(1)() podman-service(1)()
2
3
4
6 podman-system-service - Run an API service
7
8
10 podman system service [options]
11
12
14 The podman system service command creates a listening service that will
15 answer API calls for Podman. You may optionally provide an endpoint
16 for the API in URI form. For example, unix://tmp/foobar.sock or
17 tcp:localhost:8080. If no endpoint is provided, defaults will be used.
18 The default endpoint for a rootful service is unix:/run/podman/pod‐
19 man.sock and rootless is unix:/$XDG_RUNTIME_DIR/podman/podman.sock (for
20 example unix:/run/user/1000/podman/podman.sock)
21
22
23 The REST API provided by podman system service is split into two parts:
24 a compatibility layer offering support for the Docker v1.40 API, and a
25 Podman-native Libpod layer. Documentation for the latter is available
26 at https://docs.podman.io/en/latest/_static/api.html. Both APIs are
27 versioned, but the server will not reject requests with an unsupported
28 version set.
29
30
31 Note: The default systemd unit files (system and user) change the
32 log-level option to info from error. This change provides additional
33 information on each API call.
34
35
37 --time, -t
38 The time until the session expires in seconds. The default is 5 sec‐
39 onds. A value of 0 means no timeout, therefore the session will not
40 expire.
41
42
43 --help, -h
44 Print usage statement.
45
46
48 Run an API listening for 5 seconds using the default socket.
49
50
51 podman system service --timeout 5000
52
53
54
56 podman(1), podman-system-service(1), podman-system-connection(1)
57
58
60 January 2020, Originally compiled by Brent Baudebbaude@redhat.com
61 ⟨mailto:bbaude@redhat.com⟩ November 2020, Updated by Jhon Honce
62
63
64
65 podman-service(1)()