sspreitzer / shellinabox-container-image

shellinabox Container Images

Table Of Contents

• Introduction
• Version
• Usage
  • Pull The Image
  • Run The Image
• Configuration
  • Available Configuration Parameters
• References

Introduction

Dockerfile to build a shellinabox container image.

Version

Current Version: 2.20

Usage

Pull The Image

Pull the latest image, which is HEAD of the git repository.

docker pull sspreitzer/shellinabox:latest

Run The Image

For example.

docker run -p 4200:4200 -e SIAB_PASSWORD=xyz678abc -e SIAB_SUDO=true sspreitzer/shellinabox:latest

Configuration

Available Configuration Parameters

• SIAB_USERCSS: String of configured and enabled css extensions. Defaults to system default list.
• SIAB_PORT The port where shellinabox should listen to. Defaults to 4200.
• SIAB_ADDUSER Whether to create a default user. Defaults to true.
• SIAB_USER The name of the user. Defaults to guest.
• SIAB_USERID The numeric ID of the user. Defaults to 1000.
• SIAB_GROUP The primary group of the user. Defaults to guest.
• SIAB_GROUPID The numeric ID of the primary group of the user. Defaults to 1000.
• SIAB_PASSWORD The password of the user. Defaults to an autogenerated password, printed out on stdout.
• SIAB_SHELL The shell of the user. Defaults to /bin/bash.
• SIAB_HOME The home directory of the user. Defaults to /home/guest.
• SIAB_SUDO Whether to allow user to sudo. Defaults to false.
• SIAB_SSL Whether to enable ssl and create certificates on request. Defaults to true.
• SIAB_SERVICE Service strings to use for shellinabox, separated by whitespace. Defaults to local logins /:LOGIN.
• SIAB_PKGS Packages to be installed before shellinabox starts. Defaults to none.
• SIAB_SCRIPT Script to download and run before shellinabox start. SSL verification is disabled. Defaults to none.

References

• https://github.com/sameersbn/docker-gitlab/blob/master/README.md
• https://github.com/spali/docker-shellinabox

shellinabox-container-image's Issues

How to allow certain commands?

Hi,
I use this container and it works fine.
I start it using SIAB_SUDO=false so the guest account has limited access.
Now I do want to allow a few commands such as ping or nslookup.
How do I start the container in such a way sudo is not allowed except for a few commands?

Thanks in advance.

How to access host?

According to https://github.com/spali/docker-shellinabox I can add "SHELLINABOX_SERVICE_HOST" to access host, but it seems not supported here https://github.com/sspreitzer/shellinabox-container-image.

default user

Noob here.

Just want to login with my sudo user and don't creat a new one. Tried this but with no luck:
docker run -p 4200:4200 -e SIAB_ADDUSER=false -e SIAB_SUDO=true sspreitzer/shellinabox:latest

"Login incorrect"

Can you help me?

Problem with set default gw

Hi, I have a configuration like this:

version: '2'
services:
  anotherShellina:
    image: 'sspreitzer/shellinabox '
    stdin_open: true
    tty: true
    ports:
      - '4200:4200'
    networks:
      network:
        ipv4_address: 192.168.1.4
    cap_add:
      - NET_ADMIN
  Jack:
    image: 'telnet_server:latest'
    stdin_open: true
    tty: true
    networks:
      anotherSubnet:
        ipv4_address: 192.168.2.2
    cap_add:
      - NET_ADMIN
  router:
    image: 'debian_base:latest'
    stdin_open: true
    tty: true
    networks:
      network:
        ipv4_address: 192.168.1.3
      anotherSubnet:
        ipv4_address: 192.168.2.3
    cap_add:
      - NET_ADMIN
networks:
  network:
    ipam:
      config:
        - subnet: 192.168.1.1/24
  anotherSubnet:
    ipam:
      config:
        - subnet: 192.168.2.1/24

Just after docker-compose up I try to set the router programmatically by the following command:

route add default gw router 

On other containers it works, but on shellinabox I cannot connect to localhost:4200...
Anyway, if I try to change the route add with:

ip route add 192.168.1.1 via 192.168.1.3 it works, can accesso to local networks and to http login

Do you know why this ? Thanks !

Will this image allow me to be inside the container or inside the host terminal?

Want to know if running this image as is, allows me to browse the host system from the container!
Looking forward to your reply!

the latest and ubuntu images crash on missing "chpasswd"

In the minimal os images, the link from /usr/bin/passwd to /usr/bin/chpasswd is not present, causing entrypoint.sh to crash.

can't write password

i connecting to shellinabox
then write username(guest)
next i need to write password but i cant write password

How to add multiple packages with SIAB_PKGS?

Hi,
As the title suggests: how to add multiple packages with the SIAB_PKGS option?
When I add more than one comma separated it will not install anything.
Thanks in advance

Default user not found in README.md

Default user "guest"... password "xyz678abc"
Please add to readme

Question on Dark mode

Hi, thanks for the docker image, it works great. I just can't seem to get dark mode to be enabled, how do i set the docker args to set it to dark mode?