Installation - HackerHarry/mffbashbot GitHub Wiki

Windows using Cygwin

Tested on Windows 7 SP1 x86 and Windows 10 x64

Donwload and start one of the setup binaries. Cygwin, the basis for the bot, will be installed during setup. Windows might ask you if it's OK to allow lighttpd.exe through your Firewall. Please permit that. After installation, you can tell the bot which farms to process. Using your browser, surf to http://localhost/mffbashbot/ and simply use the + Farm Button. You can also configure the bot using a browser.

You can start or control the bot using the appropriate icons on your desktop or the start menu.

For manual configuration of the password, server-no. and language, see the notes in the Linux install section.

The manual gives you a deeper insight on how to start the bot.

Debian-based GNU/Linux distributions

You need at least basic Linux knowledge at this point. Please understand i can't explain here how to log on to Linux or how to edit files.

Packages like sudo, sed, wget, (p)grep etc. should be already on your box. And as the product name suggests, you'll also need the Bash ;)

Start a terminal and enter

wget https://raw.githubusercontent.com/HackerHarry/mffbashbot/master/install.sh
chmod +x install.sh
./install.sh

or, if you're feeling keen today, paste this one-liner into your terminal

bash -c "$(wget https://raw.githubusercontent.com/HackerHarry/mffbashbot/master/install.sh -O -)"

This script does most of the work for you. Please mind, the used web server lighttpd will be using port 80. If port 80 is already occupied by another servivce, let's hope you can relocate one of them.

After installation, use your browser to add farms using the localhost address mentioned below and the + Farm button.

If you need to make manual changes to the config.ini, make sure to leave the white spaces in front and behind the equal sign. Make also sure you don't use the exclamation mark ! for your first character of your password. Please also don't use the single quote ' within your password.

Congrats: The bot is now installed. Find info on how to start the bot in the manual.

You can access the bots GUI where you've installed your web server. Just use http://<IP or Hostname>/mffbashbot/ or, if it's running locally, http://localhost/mffbashbot/

Windows 10 Subsystem for Linux

Tested on Windows 10 x64 Version 1703

The WSL installation won't be covered here. There are several useful guides on the internet that'll help you install it, like this one.

The WSL version 1 should suffice.

Once WSL is installed, start it and follow the instructions from here.

Hint: The lighttpd server will not automatically start, if you have to restart the Bash shell. You might have to issue a sudo service start lighttpd command.

Android using Termux

Tested on a non-rooted Samsung Galaxy Tab A6 (SM-T580) running Android 8.1 and Termux v0.118.3

The installation under Termux is experimental. I can only offer little to no support for this setup. The following guide worked for me. It may or may not work for you. This guide assumes that you know how to install 3rd Party apps on Android. You should also be familiar with the command line.

Let's go! So, you have an old mobile phone or tablet and want to run the Bash Bot on it? May this guide bring you success!

Download Termux to your Android device and install it. Start Termux and run pkg update && pkg upgrade.

I recommend installing OpenSSH at this point, since typing via SSH is much easier than typing on a mobile device. pkg install openssh is your friend. Choose a new passwd then start the SSH daemon using sshd. You can now logon to your mobile as rooton port 8022. Using SSH is of course optional. You can start sshd along with Termux by running pkg install termux-services and sv-enable sshd. The latter command failed however during my tests due to a bug.

Next in line is proot-distro. Install it using pkg install proot-distro. After that, the Debian package proot-distro install debian. The version used in my tests was debian-bookworm-aarch64-pd-v4.17.3. Log on to the Debian package proot-distro login debian.

Within this ..well.. Debian emulation you can update and install a few packages.

apt-get update && apt-get upgrade
apt-get -qq install wget sudo dialog apt-utils

Add a new user: adduser bot. The new user receives comprehensive sudo rights. echo "bot ALL= NOPASSWD: ALL">/etc/sudoers.d/bot-no-sudo-password Run hash -r afterwards and leave the Debian environment by typing exit.

Re-login using the new user account proot-distro login --user bot debian and prepare the bot installation.

wget https://raw.githubusercontent.com/HackerHarry/mffbashbot/master/install.sh
chmod +x install.sh

Since port 80 cannot be used on non-rooted Android devices, you'll have to adjust the web servers' port within install.sh.

# change lighty's listening port
sed -i "/echo \"Configuring lighttpd...\"/a sudo sed -Ei 's/server.port\\\s+= 80/server.port = 8080/' \$LCONF" install.sh

Now you can (finally) install the bot: ./install.sh Create a socket directory for screen:

mkdir /tmp/bot
chmod 700 /tmp/bot

This is needed, since the path to the Unix domain socket file must not exceed 108 chars. Multiple hours of debugging were needed in order to find out, that this concerns the path length within the Android world.

You can now add and configure farms using http://<IP or host name>:8080/mffbashbot/ This naturally also works on the mobile device itself: http://localhost:8080/mffbashbot/

Lastly, you change screens socket directory and start the bot using export SCREENDIR=/tmp/bot/; cd; ./startallbots.sh.

If you want to run the bot on the mobile devices' console, you'll have to start it from there within the Debian environment, not from an SSH session. Duh! ;)