Overview¶

Saltbox comes with some useful command line tools and scripts. Some are meant to be utilized by Saltbox, automatically (e.g. fail2ban, torrentcleanup.py, etc), and some are for your usage.

Name	Type	Description	Invoked by	Homepage
htop	application	Interactive process viewer for Unix.	`htop`	http://hisham.hm/htop/
ctop	application	Top-like interface for container metrics.	`ctop`	https://ctop.sh/
iotop	application	Top like utility for disk I/O.	`iotop`	http://guichaz.free.fr/iotop/
nload	application	Monitor network traffic and bandwidth usage in real time.	`nload`	http://www.roland-riegel.de/nload/
vnstat	application	Network traffic monitor for that keeps a log of network traffic for the selected interface(s).	`vnstat`	http://humdi.net/vnstat/
nethogs	application	Small 'net top' tool that groups bandwidth by process.	`nethogs`	https://github.com/raboof/nethogs
ngrok	application	Secure tunnels to localhost.	`ngrok`	https://ngrok.com/
ufw	application	UFW, or Uncomplicated Firewall, is a front-end to iptables.	`ufw`	https://launchpad.net/ufw
fail2ban	application	Ban hosts that cause multiple authentication errors.	`fail2ban`	http://www.fail2ban.org
speedtest-cli	application	Command line interface for testing internet bandwidth using speedtest.net	`speedtest`	https://github.com/sivel/speedtest-cli
Rclone	application	"rsync for cloud storage".	`rclone`	https://rclone.org/
tree	application	Displays an indented directory tree, in color.	`tree`	http://mama.indstate.edu/users/ice/tree/
ncdu	application	Disk usage analyzer with an ncurses interface.	`ncdu`	https://dev.yorhel.nl/ncdu
GNU Midnight Commander	application	A visual file manager.	`mc`	https://midnight-commander.org/
hostess	application	Tool for tweaking local DNS by managing your /etc/hosts file.	`hostess`	https://github.com/cbednarski/hostess
logrotate	application	Utility is designed to simplify the administration of log files.	`logrotate`	https://fedorahosted.org/logrotate/
frontail	application	Node.js application for streaming logs to the browser, like a tail -F with a UI.	`frontail`	https://github.com/mthenw/frontail
certbot	application	Fetches and revokes certificates from Let’s Encrypt. Used by revoke_certs.sh.	`certbot`	https://certbot.eff.org/
TorrentCleanup.py	script	Cleans up extracted media files in Rutorrent's downloads folder.	Sonarr / Radarr	Credit: https://github.com/l3uddz

Details¶

-Work in progress-

Torrent Cleanup Script¶

TorrentCleanup.py has been explained in the Sonarr section, but in a nutshell, sonarr/radarr launches this script if you set it up, and it will scan the folder of the file that was imported, if rars exist, delete the file that was imported. this is useful for torrent sites that allow rars, as it will only leave you with the imported file (before its uploaded to google) and just the rars for seeding, instead of also leaving the extracted file.

NCDU¶

( cd / && sudo ncdu -x)

Frontail - view logs over http¶

[[frontail|https://github.com/mthenw/frontail]] is a Node.js application for streaming logs to the browser (basically a tail -F with an UI).

This is useful in cases you need help and need to show someone from slack support channels your logs. You can mask your IP using ngrok (more on that later).

Steps to do so are as follows:

Base command¶

frontail --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed <path of log file> &

You may change the user and password.
The & at the end sends it to the background.
You can now see this log at http://serveripaddress:9001.
To specify another port, just add: --port <port>

To create an alias for this:¶

Determine your default shell in settings.yml

For your default shell, add shell_<shell>_<shell>rc_block_custom: to your Inventory file: Example for Bash (default):

shell_bash_bashrc_block_custom: |
  ## Custom frontail alias
  alias ftail='frontail --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed '

Example for ZSH:

shell_zsh_zshrc_block_custom: |
  ## Custom frontail alias
  alias ftail='frontail --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed '

Run sb install shell

You can now use:

ftail --port <port number> <log path> &

To quit the frontail¶

pkill -f frontail

Examples:¶

Plex Autoscan¶

frontail --port 9001 --ui-highlight --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed /opt/plex_autoscan/plex_autoscan.log &

or via alias...

ftail --port 9001 /opt/plex_autoscan/plex_autoscan.log &

or via docker...

docker run --restart=always --name "frontail_plex_autoscan" -d -p 9001:9001 -v /opt/plex_autoscan:/logs -v /opt/scripts/frontail/frontail_custom_preset.json:/preset/custom.json mthenw/frontail --ui-highlight  --ui-highlight-preset /preset/custom.json --theme dark --user <user> --password <pass> /logs/plex_autoscan.log

Log: http://serveripaddress:9001

Cloudplow log¶

frontail --ui-highlight --port 9002 --ui-highlight-preset /opt/scripts/frontail/frontail_custom_preset.json --theme dark --user seed --password seed /opt/cloudplow/cloudplow.log &

Log: http://serveripaddress:9002

or via alias...

ftail --port 9002  /opt/cloudplow/cloudplow.log &

or via docker...

docker run --restart=always --name "frontail_cloudplow" -d -p 9002:9001 -v /opt/cloudplow:/logs -v /opt/scripts/frontail/frontail_custom_preset.json:/preset/custom.json mthenw/frontail --ui-highlight  --ui-highlight-preset /preset/custom.json --theme dark --user <user> --password <pass> /logs/cloudplow.log

Log: http://serveripaddress:9002

Use ngrok to hide your IP¶

If you want to share your log with someone (forums, slack, etc), but don't want to reveal your IP address, you can use ngrok to hide your IP address.

ngrok http <port>

It will show you something like this...

You can now use the http://XXXXXXXX.ngrok.io address to share your log. This will be active as long as ngrok is running. To cancel, ctrl-c.