It provides a CLI client for Geofront, a simple SSH key management server.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Geofront CLI client

Latest PyPI version

It provides a CLI client for Geofront, a simple SSH key management server.


It is available on PyPI, so you can install it using pip installer.

$ pip install geofront-cli

Getting started

What you have to do first of all is to configure the Geofront server URL. Type geofront-cli start and then it will show a prompt:

$ geofront-cli start
Geofront server URL:

We suppose here. It will open an authentication page in your default web browser:

$ geofront-cli start
Geofront server URL:
Continue to authenticate in your web browser...
Press return to continue

List available remotes

You can list the available remotes using geofront-cli remotes command:

$ geofront-cli remotes

If you give -v/--verbose option it will show their actual addresses as well:

$ geofront-cli remotes -v
web-1        ubuntu@
web-2        ubuntu@
web-3        ubuntu@
worker-1     ubuntu@
worker-2     ubuntu@
db-1 ubuntu@
db-2 ubuntu@

SSH to remote

You can easily connect to a remote through SSH. Use geofront-cli ssh command instead of vanilla ssh:

$ geofront-cli ssh web-1
Welcome to Ubuntu 12.04.3 LTS (GNU/Linux 2.6.32-042stab078.27 i686)

 * Documentation:

There is geofront-cli scp command as well, which is corresponding to scp:

$ geofront-cli scp file.txt web-1:file.txt
file.txt                                      100% 3157     3.1KB/s   00:00
$ geofront-cli scp -r web-1:path/etc/apt ./
sources.list                                  100% 3157     3.1KB/s   00:00
trusted.gpg                                   100%   14KB  13.9KB/s   00:00

Missing features

  • Shortcut for geofront-cli ssh command
  • Make geofront-cli ssh similar to ssh
  • Autocompletion

Author and license

Hong Minhee wrote geofront-cli, and Spoqa maintains it. It is licensed under GPLv3 or later.


Version 0.3.2

Released on May 31, 2016.

  • Fixed ImportError on Python 2.6.

Version 0.3.1

Released on May 28, 2016.

  • Forward compatibility with Geofront 0.4.

Version 0.3.0

Released on January 15, 2016.

  • Fixed an AttributeError during handling error sent by server. [#4]

Version 0.2.2

Released on November 14, 2014.

  • Added -v/--version option.
  • Fixed an AttributeError during handling error from server. [#2, #3 by Lee Jaeyoung]

Version 0.2.1

Released on June 29, 2014.

  • Added geofront-cli scp command.
  • Added the short option -S for --ssh.
  • It becomes to no more depend on dirspec. Instead it's simply bundled together.
  • geofront-cli now prints a usage description when no subcommand specified.

Version 0.2.0

Released on May 3, 2014.

  • Added handling of unfinished authentication error.
  • Added handling of incompatible protocol version.

Version 0.1.1

Released on April 22, 2014.

  • Fixed Python 2 incompatibility.
  • Added warning for non-SSL server URL.

Version 0.1.0

First pre-alpha release. Released on April 21, 2014.