Skip to content

installation procedure

Exxerial edited this page Jul 15, 2019 · 14 revisions


  • Step by step installation (Kali Linux, Debian or Ubuntu & Mac Os is supported by homebrew)

    (For Ubuntu : Execute all the following commands using sudo then insert QT_X11_NO_MITSHM=1 at the end of the file: /etc/environment and always launch hardsploit_gui as root)

    • Open a new terminal on the desktop


    • Install packages needed (ruby must be >= 2.1) with the following command (+ some dependancies that we will try to reduce):
    apt-get install ruby ruby-dev cmake build-essential dfu-util libqt4-dev libusb-1.0-0 bison openssl libreadline5 libreadline-dev curl git-core zlib1g zlib1g-dev libssl-dev vim libsqlite3-0 libsqlite3-dev sqlite3 libxml2-dev git-core subversion autoconf xorg-dev libgl1-mesa-dev libglu1-mesa-dev
    • Install the gems used by Hardsploit

    if you use GCC > 5.4 you need to use GCC 5.4 at least to be sure qtbindings gem can be compile without any issue, to do that :

    export CC=gcc-5
    export CXX=g++-5
    gem install qtbindings activerecord libusb sqlite3
    • Install Sqlite (version 1.3.9):
    gem install sqlite3 -v 1.3.9

    Install the GUI by using the gem

    gem install hardsploit_gui

    That's it ! Hardsploit is now ready to be launched. Connect your board by USB and type in the terminal


    At the opening you will have in the console either this message:


    Or this one:


    If you have this last one, please check your USB connectivity. Don't forget that if you are using a virtual machine you have to attach Hardsploit to it. Hardsploit doesn't manage hotswap yet so you will have to

    • close the GUI
    • connect your board
    • launch the GUI again

    Hardsploit can be used without being connected but you will not have the possibility to execute commands or to use the wiring helper

For the next part it's this way