osgish - A OSGi Shell


  osgish [options] <server>

  osgish --help

  osgish --version

   --user <user>           Credential used for authentication   
   --password <pwd>  
   --proxy <url>           URL to proxy
   --proxy-user <user>     Authentication information for a proxy
   --proxy-password <pwd>
   --config <cfg-file>     Path to an optional configuration file (default: ~/.osgish)
   --color [yes|no]        Color option (default: yes)

An optional argument can be used to directly connect to an agent URL or symbolic name as defined in the configuration file. If not given, the shell does no initial connect.


Osgish is the administrator's shell for OSGi. It's focus is on simple usage for common administrative tasks. There are many other shells for OSGi as well, most (if not all) implemented in Java. Osgish unique features are

  • Readline and history support based on GNU Readline/History as known from other shells like 'bash'. When GNU Readline is not available, a pure Perl Module is used instead.

  • Context sensitive argument completion, e.g. on bundle symbolic names.

  • Colored output (can be switched off)

  • Multi-Server support

  • Remote operation via HTTP(S)


This file is part of osgish.

Osgish is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

osgish is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with osgish. If not, see <>.

A commercial license is available as well. Please contact for further details.


Just in case you need professional support for this module (or JMX or OSGi in general), you might want to have a look at Contact for further information (or use the contact form at