1REMOTECTL(8)                       remotectl                      REMOTECTL(8)
2
3
4

NAME

6       remotectl - Remote Access Configuration
7

SYNOPSIS

9       remotectl {COMMAND} [OPTIONS...]
10

DESCRIPTION

12       The remotectl program will configure remote access to the system.
13       Currently it manages cockpit's SSL certificate.
14

COMMANDS

16       certificate
17           Manage Cockpit's SSL certificate. If used without options will
18           check if cockpit has a valid certificate without making any
19           changes.
20
21           --ensure Ensure that a certificate exists and can be loaded. If
22           none exists, create a 0-self-signed.cert certificate, using sscg[1]
23           (if available) or openssl[2]. That self-signed default certificate
24           will be automatically renewed when it expires.
25
26           --user username The unix user that should own the certificate. Only
27           takes effect if used with --ensure.
28
29           --group groupname The unix group that should read the certificate.
30           Only takes effect if used with --ensure.
31
32           If any additional arguments are given, they are treated as files
33           that should be combined to create a certificate file. If the
34           combined files validate, they will be saved in the appropriate
35           location using the name of the first file given with the extension
36           changed to .cert. For example:
37
38           remotectl certificate server.pem chain.pem key.pem
39
40           will result in server.cert. If server.cert already exists it will
41           be overwritten.
42

OPTIONS

44       --help
45           Show help options.
46
47       --verbose
48           Print verbose messages about the task
49

BUGS

51       Please send bug reports to either the distribution bug tracker or the
52       upstream bug tracker[3].
53

AUTHOR

55       Cockpit has been written by many contributors[4].
56

SEE ALSO

58       cockpit-ws(8)
59

NOTES

61        1. sscg
62           https://github.com/sgallagher/sscg
63
64        2. openssl
65           https://linux.die.net/man/1/openssl
66
67        3. upstream bug tracker
68           https://github.com/cockpit-project/cockpit/issues/new
69
70        4. contributors
71           https://github.com/cockpit-project/cockpit/
72
73
74
75cockpit                           05/16/2021                      REMOTECTL(8)
Impressum