Installing and running AquaShell on Linux systems
avatar
Posted by Daniel Brendel
1 month ago
So, yeah, you can install and run AquaShell on Linux as well! Since it comes as a Windows x64 executable, you need to use WINE to run it. In this blog post I'm guiding you through the steps of the install process.

At first we're downloading the latest AquaShell build, which is v1.0.1 when writing this article.


wget https://github.com/danielbrendel/dnyAquaShell/releases/download/v1.0.1/AquaShell-v1.0.1.zip
unzip AquaShell-v1.0.1.zip


The next step is to install WINE if you haven't already.


apt update
apt install wine
dpkg --add-architecture i386 && apt-get update && apt-get install wine32:i386
winecfg


And then check if WINE is successfully installed:


wine --version


Now we can check if WINE runs the shell executable:


cd AquaShell-v1.0.1
WINEDEBUG=-all wine dnyAquaShell.exe -v


You should get an output like this:


* AquaShell (dnyAquaShell) v1.0
* An open-source project released under the MIT license
* Developed by Daniel Brendel (https://www.danielbrendel.com)
* Repository: https://github.com/danielbrendel/dnyAquaShell


We should now put the AquaShell contents to a more suitable place, I'm using /bin in this case, but choose for yourself depending on your environment.


mkdir -p /bin/AquaShell
cp -r ~/AquaShell-v1.0.1/* /bin/AquaShell/


Now we create a bash script that functions as a globally available gateway to AquaShell:


nano /usr/local/bin/aquashell


The content of the bash script is as follows:


#!/bin/bash
WINEDEBUG=-all wine /bin/AquaShell/dnyAquaShell.exe "$@"


Make it executable:


chmod +x /usr/local/bin/aquashell


Now AquaShell should be globally available:


root@ubuntu:~# aquashell -v
* AquaShell (dnyAquaShell) v1.0
* An open-source project released under the MIT license
* Developed by Daniel Brendel (https://www.danielbrendel.com)
* Repository: https://github.com/danielbrendel/dnyAquaShell


Let's create a scripts directory, add a test script, and then run it:


mkdir aquashell_snippets
cd aquashell_snippets
nano recursive.dnys


Put in the following script code. It's a sample that shows recursive function calling:


# Demonstrate recursive function calls

const MAX_COUNT int <= 10;

function recursive void(count int)
{
  if (%count, -ls, %MAX_COUNT) {
    ++ count;
    print "Count value: %count";
    call recursive(%count) => void;
  };
};

call recursive(0) => void;

print "Done.";

pause;


Let's execute the script and verify it runs as expected:


root@ubuntu:~/aquashell_snippets# aquashell recursive.dnys
Count value: 1
Count value: 2
Count value: 3
Count value: 4
Count value: 5
Count value: 6
Count value: 7
Count value: 8
Count value: 9
Count value: 10
Done.
Press any key to continue...


That's it! You've successfully installed AquaShell on a Linux environment!
Imprint
© 2025 by Daniel Brendel

Scientia potentia est

Visitors: 14.1K