---
name: "remotectl"
section: "8"
platform: "linux"
package: "cockpit-ws"
version: "239-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/remotectl"
---

# remotectl(8)

Remote Access Configuration

## NAME

remotectl - Remote Access Configuration

## SYNOPSIS

**remotectl** {COMMAND} \[OPTIONS...\]

## DESCRIPTION

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

## COMMANDS

**certificate**

Manage Cockpit's SSL certificate. If used without options will check if cockpit has a valid certificate without making any changes.

**--ensure** Ensure that a certificate exists and can be loaded. If none exists, create a 0-self-signed.cert certificate, using **sscg**\[1\] (if available) or **openssl**\[2\]. That self-signed default certificate will be automatically renewed when it expires.

**--user username** The unix user that should own the certificate. Only takes effect if used with **--ensure**.

**--group groupname** The unix group that should read the certificate. Only takes effect if used with **--ensure**.

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:

**remotectl certificate server.pem chain.pem key.pem**

will result in server.cert. If server.cert already exists it will be overwritten.

## OPTIONS

- **--help**

  Show help options.

- **--verbose**

  Print verbose messages about the task

## BUGS

Please send bug reports to either the distribution bug tracker or the **upstream bug tracker**\[3\].

## AUTHOR

Cockpit has been written by many **contributors**\[4\].

## SEE ALSO

[**cockpit-ws**(8)](/cockpit-ws/8.md)

## NOTES

- 1\.

  sscg

  https://github.com/sgallagher/sscg

- 2\.

  openssl

  https://linux.die.net/man/1/openssl

- 3\.

  upstream bug tracker

  https://github.com/cockpit-project/cockpit/issues/new

- 4\.

  contributors

  https://github.com/cockpit-project/cockpit/