1COCKPIT-DESKTOP(1)              cockpit-desktop             COCKPIT-DESKTOP(1)
2
3
4

NAME

6       cockpit-desktop - Cockpit Desktop integration
7

SYNOPSIS

9       cockpit-desktop {URLPATH} [SSH_HOST]
10

DESCRIPTION

12       The cockpit-desktop program provides secure access to Cockpit pages in
13       an already running desktop session. It starts a web server (cockpit-ws)
14       and a web browser in an isolated network namespace, and a cockpit-
15       bridge(8) in the running user session.
16
17       This avoids having to log into Cockpit, and having to enable
18       cockpit.socket system-wide. The network isolation ensures that no other
19       user, and not even other processes in the user's session, can access
20       this local web server.
21
22       URLPATH is the Cockpit page to open, i. e. the path component of
23       Cockpit URLs. It is highly recommended to only open a particular page
24       frame[1], not the entire Cockpit navigation and menu. For example, the
25       path /cockpit/@localhost/storage/index.html will open the Storage page.
26       It is also possible to give abbreviated forms of urls, such as
27       "storage" or "network/firewall".
28
29       SSH_HOST is an optional SSH remote host specification (hostname or
30       username@hostname). If given, cockpit-bridge will be started on the
31       remote host through ssh(1) instead, i. e. the Cockpit web browser will
32       show that remote host. Note that this is more of an experimental/demo
33       feature.
34

ENVIRONMENT

36       The BROWSER environment variable specifies the browser command (and
37       possibly options) that will be used to open the requested Cockpit page.
38       If not set, cockpit-desktop attempts to use an internal minimalistic
39       WebKit browser, and failing that, will attempt to detect some
40       reasonable alternatives.
41

BUGS

43       Please send bug reports to either the distribution bug tracker or the
44       upstream bug tracker[2].
45

AUTHOR

47       Cockpit has been written by many contributors[3].
48

SEE ALSO

50       cockpit-ws(8), cockpit-bridge(1)
51

NOTES

53        1. particular page frame
54           https://cockpit-project.org/guide/latest/embedding.html
55
56        2. upstream bug tracker
57           https://github.com/cockpit-project/cockpit/issues/new
58
59        3. contributors
60           https://github.com/cockpit-project/cockpit/
61
62
63
64cockpit                           12/15/2023                COCKPIT-DESKTOP(1)
Impressum