'\" t
.\"     Title: remotectl
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/22/2021
.\"    Manual: remotectl
.\"    Source: cockpit
.\"  Language: English
.\"
.TH "REMOTECTL" "8" "08/22/2021" "cockpit" "remotectl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
remotectl \- Remote Access Configuration
.SH "SYNOPSIS"
.HP \w'\fBremotectl\fR\ 'u
\fBremotectl\fR {COMMAND} [OPTIONS...]
.SH "DESCRIPTION"
.PP
The
\fBremotectl\fR
program will configure remote access to the system\&. Currently it manages cockpit\*(Aqs SSL certificate\&.
.SH "COMMANDS"
.PP
\fBcertificate\fR
.RS 4
Manage Cockpit\*(Aqs SSL certificate\&. If used without options will check if cockpit has a valid certificate without making any changes\&.
.sp
\fB\-\-ensure\fR
Ensure that a certificate exists and can be loaded\&. If none exists, create a
0\-self\-signed\&.cert
certificate, using
\m[blue]\fBsscg\fR\m[]\&\s-2\u[1]\d\s+2
(if available) or
\m[blue]\fBopenssl\fR\m[]\&\s-2\u[2]\d\s+2\&. That self\-signed default certificate will be automatically renewed when it expires\&.
.sp
\fB\-\-user username\fR
The unix user that should own the certificate\&. Only takes effect if used with
\fB\-\-ensure\fR\&.
.sp
\fB\-\-group groupname\fR
The unix group that should read the certificate\&. Only takes effect if used with
\fB\-\-ensure\fR\&.
.sp
If any additional arguments are given, they are treated as files that should be combined to create a certificate file\&. If the combined files validate, they will be saved in the appropriate location using the name of the first file given with the extension changed to \&.cert\&. For example:
.sp
\fBremotectl certificate server\&.pem chain\&.pem key\&.pem\fR
.sp
will result in
server\&.cert\&. If
server\&.cert
already exists it will be overwritten\&.
.RE
.SH "OPTIONS"
.PP
\fB\-\-help\fR
.RS 4
Show help options\&.
.RE
.PP
\fB\-\-verbose\fR
.RS 4
Print verbose messages about the task
.RE
.SH "BUGS"
.PP
Please send bug reports to either the distribution bug tracker or the
\m[blue]\fBupstream bug tracker\fR\m[]\&\s-2\u[3]\d\s+2\&.
.SH "AUTHOR"
.PP
Cockpit has been written by many
\m[blue]\fBcontributors\fR\m[]\&\s-2\u[4]\d\s+2\&.
.SH "SEE ALSO"
.PP
\fBcockpit-ws\fR(8)
.SH "NOTES"
.IP " 1." 4
sscg
.RS 4
\%https://github.com/sgallagher/sscg
.RE
.IP " 2." 4
openssl
.RS 4
\%https://linux.die.net/man/1/openssl
.RE
.IP " 3." 4
upstream bug tracker
.RS 4
\%https://github.com/cockpit-project/cockpit/issues/new
.RE
.IP " 4." 4
contributors
.RS 4
\%https://github.com/cockpit-project/cockpit/
.RE