dmgolembiowski / cast-sh

:pager: An instance of your terminal in your browser

Installation & Prerequisites

Use the package manager pip to install the dependencies before run the application

pip3 install -r requirements.txt

Usage

To start the terminal cast application, run:

python3 -m cast

Or if you install the application via pip:

pip install .

# command available once pkg has been installed
cast-sh

Arguments

optional arguments:

  -h, --help                show this help message and exit
  -p [PORT], --port [PORT]  port to run server on (default: 5000)
  --debug                   debug the server (default: False)
  --version                 print version and exit (default: False)
  --command COMMAND         Command to run in the terminal (default: bash)
  --cmd-args CMD_ARGS       arguments to pass to command (i.e. --cmd-args='arg1
                            arg2 --flag') (default: )
  --password PASSWORD       set a password for accessing cast-sh
                            sessions (default: admin)

A password can be set using an environment variable as well.

Unix

export PASSWORD="weakpassword"

Windows

set PASSWORD="weakpassword"

Docker

Build image

docker build -t cast .

Run built image

docker run --name cast.sh-container -p 5000:5000/tcp -i -t cast

Screenshots

Contributing

License

Code of Conduct

Everyone interacting with the cast-sh codebase and issue tracker is expected to follow our Code of Conduct.