Difference between revisions of "Shellinabox"

From SME Server
Jump to navigationJump to search
(Created page with "{{Languages}} == 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 contri...")
 
 
(3 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
== Smeserver-shellinabox for SME Server 8 and 9==
 
== 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 contribs is tested with chrome and IE, it seems that with Firefox you can have issues with certain characters, especially if your keyboard is not  in English. This is the official website to report issues on [https://code.google.com/p/shellinabox/ shellinabox]
+
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
 
=== Maintainer ===
 
=== Maintainer ===
 
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />
 
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />
 +
===Version===
 +
 +
{{#smeversion: smeserver-shellinabox }}
 +
[[Version::contrib9|stephdl]][[Has SME9::true| ]]
  
 
=== Description ===
 
=== Description ===
Line 28: Line 32:
 
  signal-event shellinaboxd
 
  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.
+
now you can use the contrib in the server-manager or with the url https://sme-host_or_ip/shell <br />
 +
 
 +
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
 
this is the default DB value
Line 37: Line 43:
 
     Name=shell                #You can change this folder if you want
 
     Name=shell                #You can change this folder if you want
 
     PublicAccess=local        #local=localnetwork,global=internet,IP=one IP allowed,none=no access
 
     PublicAccess=local        #local=localnetwork,global=internet,IP=one IP allowed,none=no access
     ShellUsers=              #SME users allowed to use shellinabox, use coma to separate users : user1,user2,user3
+
     ShellUsers=              #SME users allowed to use shellinabox only through the apache authentication, use coma to separate users : user1,user2,user3
 
     TcpPort=1870              #You can change the port if you want
 
     TcpPort=1870              #You can change the port if you want
 
     WebAuth=disabled          #Force or not the apache authentication : enabled/disabled
 
     WebAuth=disabled          #Force or not the apache authentication : enabled/disabled
Line 55: Line 61:
  
 
=== Bugs ===
 
=== Bugs ===
For now there is no entry on bugzilla, please direct your issue to [mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />
+
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 +
and select the smeserver-shellinabox component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-shellinabox|title=this link}}
 +
<br />
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-shellinabox|noresultsmessage="No open bugs found."}}
 +
 
 +
===Changelog===
 +
Only versions released in smecontrib are listed here.
  
 +
{{#smechangelog: smeserver-shellinabox}}
 
[[Category: Contrib]]
 
[[Category: Contrib]]

Latest revision as of 04:53, 18 April 2021


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

Maintainer

stephdl Stéphane de Labrusse AKA Stephdl

Version

Devel 10:
smeserver-shellinabox
The latest version of smeserver-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

Requirements

You need to enable the stephdl and epel repositories

Installation

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 precise which IP can connect (You have to set PublicAccess to IP)
   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 coma 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


IDProductVersionStatusSummary
12376SME Contribs10.0RESOLVEDMigrate to systemd and fix httpd config

Changelog

Only versions released in smecontrib are listed here.