Shellinabox

Languages:

English

shellinabox

shellinabox logo
Maintainer	Stephdl
Url	https://github.com/shellinabox/shellinabox
Source:	smeserver-shellinabox
Source:	shellinabox
Licence	open source
Category	Administration
Tags	Shell, Webshell

Smeserver-shellinabox for SME Server 8 and 9

This contrib is made to help the managing of the command line with a terminal in your web browser. This is the official website to report issues on https://github.com/shellinabox/shellinabox.

Version

smecontribs 11:

0.0.8-7

smetest 10:

0.0.8-4

smeserver-shellinabox

The latest version of smeserver-shellinabox is available in the SME repository, click on the version number(s) for more information.

smecontribs 11:

2.20-27

shellinabox

The latest version of shellinabox is available in the SME repository, click on the version number(s) for more information.

stephdl

Description

The purpose is to have in the server-manager an ajax web based emulator instead to use putty or a terminal. The RPM comes from epel...This contribs is done either for sme8 or sme9.

Installation

For SME 11For SME 10For SME 9

dnf install smeserver-shellinabox 

Remember to first configure the required epel repositories, then issue the following command on the SME Server shell:

yum install smeserver-shellinabox --enablerepo=epel

Remember to first configure the required stephdl and epel repositories, then issue the following command on the SME Server shell:

yum install smeserver-shellinabox --enablerepo=stephdl,epel

The 'official' way is to perform

signal-event post-upgrade;  signal-event reboot

but if you don't want to reboot your server, do :

signal-event console-save

or

signal-event shellinaboxd

now you can use the contrib in the server-manager or with the url https://sme-host_or_ip/shell

Go to the panel of shellinabox on Server Manager (ssh via a web browser) and use the credentials of root to login, think to test the right clic, you will find other options.

this is the default DB value

# config show shellinaboxd 
shellinaboxd=service
   FixedIP=                  #You can control which IP can connect (You have to set PublicAccess to one)
   Name=shell                #You can change this folder if you want
   PublicAccess=local        #local=localnetwork,global=internet,IP=one IP allowed,none=no access
   ShellUsers=               #SME users allowed to use shellinabox only through the apache authentication, use comma to separate users : user1,user2,user3
   TcpPort=1870              #You can change the port if you want
   WebAuth=disabled          #Force or not the apache authentication : enabled/disabled
   status=enabled            #enabled or disabled

• Admin or ShellUsers are real users of server-manager with their credentials (used only for the http authentication).
• HTTPS is always forced.
• The Apache authentication is only forced if the PublicAccess is not set to local, you have to authenticate throught apache with admin or using ShellUsers.
• If you want you can force the apache authentication with the DB WebAuth (set it to enabled to enforce).

for example :

config setprop shellinaboxd PublicAccess global
signal-event shellinaboxd

Uninstall

yum remove smeserver-shellinabox; signal-event console-save

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-shellinabox component or use this link

ID	Product	Version	Status	Summary
13582	SME Contribs	11.0	CONFIRMED	deprecate and find alternative

Changelog

Only versions released in smecontrib are listed here.

smeserver-shellinabox-0.0.8-7.el8.sme Changelog: SME 11 (smecontribs)

2026/06/09 Jean-Philippe Pialasse 0.0.8-7.sme
- login using rsa ssh key.

- TODO allow only a subset of commands.

2026/06/09 Jean-Philippe Pialasse 0.0.8-6.sme
- SM2 panel
- fix for htppd 2.4

- switch to tkt auth

2024/09/07 cvs2git.sh aka Brian Read 0.0.8-5.sme
- Roll up patches and move to git repo [SME: 12338]

2024/09/07 BogusDateBot
- Eliminated rpmbuild "bogus date" warnings due to inconsistent weekday,

by assuming the date is correct and changing the weekday.

2024/09/06 Terry Fage 0.0.8-4.sme
- add locale 2024-09-06.patch