=head1 Config::Model::OpenSsh - OpenSSH graphical configuration editor This module provides a graphical configuration editor for: =over =item C</etc/ssh/sshd_config> =item C</etc/ssh/ssh_config> =item C<~/.ssh/config> =back =head1 Installation =head2 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 =head2 On Mac or Windows The easiest way is to: =over =item * install Perl from L<ActiveState|http://www.activestate.com/activeperl>, =item * Run PPM =item * Select and install C<app-cme>, C<config-model-openssh> and C<config-model-tkui> =back =head2 Other You can also install these modules from CPAN: cpanm App::Cme cpanm Config::Model::OpenSsh cpanm Config::Model::TkUI =head1 Usage Once this module is installed, you can launch a GUI to edit C</etc/ssh/sshd_config> with: $ sudo cme edit sshd If L<cme> fails to load your C<sshd_config>, you can try L<cme> with C<-force> option. Likewise, you can edit your C<~/.ssh/config> file with: $ cme edit ssh Or to edit C</etc/ssh/ssh_config>, run as root: $ sudo cme edit system-ssh More details are given in L<Managing ssh configuration with cme|https://github.com/dod38fr/config-model/wiki/Managing-ssh-configuration-with-cme> wiki page. =head1 Build from git repository See L<README-build-from-git|https://github.com/dod38fr/config-model-openssh/blob/master/README-build-from-git.md>. =head1 More information For more information, see: =over =item * L<Managing ssh configuration with cme|https://github.com/dod38fr/config-model/wiki/Managing-ssh-configuration-with-cme> wiki page =item * L<Using cme|https://github.com/dod38fr/config-model/wiki/Using-cme> wiki page =item * L<config-model wiki|https://github.com/dod38fr/config-model/wiki> =back =head1 Installation from git L<Config::Model::OpenSsh> is built with L<Dist::Zilla>. Please follow the L<instructions to build Config::Model with git|https://github.com/dod38fr/config-model/blob/master/README.build-from-git> to install all modules related to L<Dist::Zilla>. Then, make sure that L<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 =head1 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 L<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 L<wiki page|https://github.com/dod38fr/config-model/wiki/How-to-add-a-new-parameter-to-an-existing-model>