Skip to content

Execute shell command on your server as REST service.

Notifications You must be signed in to change notification settings

fdefelici/shellst

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SHELLST Build Status

Shellst allow you to access your server shell by rest api. Useful in case you can't access remotly your server by ssh.

Both Windows (cmd) and Unix (sh) shell are supported.

Running shellst

java [OPTIONS] -jar shellst-<version>.jar

Available options:

  • -Dport: Specify listening port (default: 4567)
  • -Dtoken: Specify a token to access api (default: not set)

NOTE: Options can be passed also as environment variables

API

HELO

To check if application is working

Curl Example:

curl "http://localhost:4567/"

EXEC SHELL COMMAND

Run a shell command on the host machine (like ssh command)

Curl Example:

curl -X POST "http://localhost:4567/shell/exec" --data-urlencode "cmd=mkdir /tmp/mydir"

COPY

Run a copy file from client to server. (like scp command)

Curl Example:

curl "http://localhost:4567/shell/copy" -F "file=@local/file/path/myfile.example" -F "path=/dest/path/filename.example"

NOTE: like scp destination path must exists

About

Execute shell command on your server as REST service.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages