# shellinabox

**Repository Path**: x2ai/shellinabox

## Basic Information

- **Project Name**: shellinabox
- **Description**: shellinabox
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2016-05-05
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Shellinabox for DomeOS
===

Shellinabox implements a web server that can export arbitrary command line tools to a web based terminal emulator. This is a modified version for DomeOS, providing quick access to docker container via web terminal by simply specifying intended host address and container ID.

## Running in a container

It's recommended that the program run in a docker container:

```bash
sudo docker run -d --restart=always -p 4200:4200 --name shellinabox domeos/shellinabox:latest
```

## Usage

Remote hosts can be accessed through urls like: http://localhost:4200/domeos@\<host address\>@/

Remote containers can be accessed through urls like: http://localhost:4200/domeos@\<host address\>@\<container ID\>@/

Here are some examples:

http://localhost:4200/domeos@10.11.150.71@/
http://localhost:4200/domeos@10.11.150.71@e5e7d49bbd28@/

Note that for container-accessing, dockerConnector must be installed on hosts appointed container is running on, while host-accessing needn't.