Edit and validate OpenSSH configuration (system and user)
Perl
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
demo
lib/Config/Model
t
.gitignore
.travis.yml
Build.PL
Changes
MANIFEST.SKIP
README-build-from-git.md
README.pod
dist.ini
weaver.ini

README.pod

Config::Model::OpenSsh - OpenSSH graphical configuration editor

This module provides a graphical configuration editor for:

/etc/ssh/sshd_config
/etc/ssh/ssh_config
~/.ssh/config

Installation

Debian or Ubuntu

As root,type:

sudo apt install cme libconfig-model-openssh-perl

To get the GUI, you should also do:

sudo apt install libconfig-model-tkui-perl

On Mac or Windows

The easiest way is to:

  • install Perl from ActiveState,

  • Run PPM

  • Select and install app-cme, config-model-openssh and config-model-tkui

Other

You can also install these modules from CPAN:

cpanm App::Cme
cpanm Config::Model::OpenSsh
cpanm Config::Model::TkUI

Usage

Once this module is installed, you can launch a GUI to edit /etc/ssh/sshd_config with:

$ sudo cme edit sshd

If cme fails to load your sshd_config, you can try cme with -force option.

Likewise, you can edit your ~/.ssh/config file with:

$ cme edit ssh

Or to edit /etc/ssh/ssh_config, run as root:

$ sudo cme edit system-ssh

More details are given in Managing ssh configuration with cme wiki page.

Build from git repository

See README-build-from-git.

More information

For more information, see:

Installation from git

Config::Model::OpenSsh is built with Dist::Zilla.

Please follow the instructions to build Config::Model with git to install all modules related to Dist::Zilla.

Then, make sure that Config::Model is installed.

On debian or ubuntu, do:

sudo apt-get build-dep libconfig-model-openssh-perl

Then run:

dzil build

If you want to install this software without packaging, you can also run:

dzil install

Update OpenSSH model

To update the model, the easiest way is to use the following command in the git repo:

$ cme meta edit

This command requires Config::Model::Itself.

On debian or ubuntu, do:

sudo apt install libconfig-model-itself-perl

Then you can explore the configuration elements in the GUI.

For more information on model update, see this wiki page