Skip to main content

Mudfish OVA Installation

Mudfish Cloud VPN based on OpenWRT firmware for virtual machine is based on the x86_64 architecture. Basically the Mudfish Core package and the Luci web UI packages are pre-installed.

Supported Virtual Machines​

Currently, the following virtual machines are officially supported.

How to install OVA​

Oracle VM VirtualBox​

Import OVA image​

To install Mudfish in Oracle VM VirtualBox, first You need to download the OVA file.

Then, import the OVA file in the following order.

  1. Run VirtualBox.

  2. Click 'File -> Import appliance' menu and specify the location of the downloaded OVA filein Source tab

  3. Then you will see the basic virtual machine configuration. The important part is 'Mac Address Policy'. Please select one of the following options.

    • Include all network adapter MAC addresses

  4. Import. Then 'OpenWRT with Mudfish <version>' will be created.

Congratulations! Mudfish VM installation completed successfully. at this point Here is a checklist to check:

Checklist

  • Open the Settings menu of 'OpenWRT with Mudfish <version>', Go to the Network tab.

  • The status of Adapter 1 should be:

    • Enable Network Adapter must be checked.

    • Attached to must be a Host-only Adapter.

    • Name should usually be vboxnet0. If no name can be found, you can create it in the 'File -> Host Network Manager' menu in the VirtualBox window,

      For the current Mudfish OVA image, it assumes that vboxnet0 is set as:

      • Name: vboxnet0
      • IPv4 Address/Mask: 192.168.56.1/24
      • DHCP Server: Enabled

  • The status of Adpater 2 should be:

    • Enable Network Adapter must be checked.
    • Attached to must be a Bridged Adapter.
    • Name must be the name of the network card connected to the current Internet line.

About 10 to 15 seconds after running this VM, when I hit Enter on the VM console, You can do console work.

Luci UI access and Mudfish settings​

Open a browser on the host machine and connect to http://192.168.56.2. There is no root password as default.

If you want SSH connection, connect as ssh root@192.168.56.2 You can do console work.

To access the Mudfish UI running on the virtual machine, after logging in, please go to "Service -> Mudfish" menu. Usually the Mudfish is running at http://192.168.56.2:8282.

Changing Default Gateway​

Now it's time to redirect the traffic to OpenWRT with Mudfish on the virtual machine.

If you want to change it only once, you can set it as follows. in other words, Rebooting the computer will restore the old (your default) settings.

OpenWRT with Mudfish must be running on the virtual machine.

  1. Run "Command Prompt" as administrator.

  2. Delete the existing route with ROUTE DELETE 0.0.0.0.

  3. ROUTE ADD 0.0.0.0 MASK 0.0.0.0 192.168.56.2 METRIC 1 Add a new default gateway with the command.

  4. Now check if the ping with ping 192.168.56.2 is working properly.

VMware Workstation 16 Player​

You can import the OVA file in the following order.

  1. Launch VMware Workstation 16 Player. "Open a Virtual Machine" After clicking the "Open a Virtual Machine" menu, specify the Mudfish OVA file received above.

  2. When the 'Import Virtual Machine' window appears, enter the following information:

    • Enter OpenWRT with Mudfish in "Name for the new virtual machine"

    • In the case of "Storage path for the new virtual machine", when entering the above, it will be completed automatically.

  3. If "The import failed because ... did not pass OVF specification..." message appears, click the Retry button.

  4. If there is no problem, you can check that the import was successful.

Checklist

  • After selecting the 'OpenWRT with Mudfish' item, click the 'Edit virtual machine settings' menu to open the setting screen.

  • The status of Network Adapter should be as follows.

  • 'Connect at power on' must be checked.

  • Network connection must be Host-only. Normally, if this is specified, the VMNet1 device will be linked.

    And usually, in case of VMNet1, the Host-only IP is set to 192.168.139.1.

  • The status of Network Adapter 2 should be as follows.

  • 'Connect at power on' must be checked.

  • Network connection must be Bridged.

  • The important part is to click the "Configure Adapters" button, and select the network device connected to the Internet line, and deselect the rest.

  1. Now boot the OpenWRT with Mudfish image. After about 8 to 10 seconds, if you press the Enter key on the screen, you will be connected to the console.

  2. Lastly, you need to change the internal LAN IP. These commands change the internal LAN IP to 192.168.139.2.

    uci set network.lan.ipaddr='192.168.139.2'
    uci commit
    reboot

  3. If the reboot is successful, now open a browser and connect to http://192.168.139.2.

Luci UI access and Mudfish settings​

Open a browser on the host machine and connect to http://192.168.139.2. There is no access root password.

If you want SSH access, connect as ssh root@192.168.139.2 and you can do console work.

To access the Mudfish UI running on the virtual machine, connect to the Web Luci UI and then go to the "Service -> Mudfish" menu.

Usually, Mudfish is running at http://192.168.139.2:8282. You can set the Mudfish on OpenWRT through this menu. If you are familiar with using the ipTIME Mudfish router, you will be able to set it up easily.

Changing Default Gateway​

Now it's time to redirect the traffic to OpenWRT with Mudfish on the virtual machine.

If you want to change it only once, you can set it as follows. In other words, rebooting the computer will restore the original settings.

OpenWRT with Mudfish must be running on the virtual machine.

  1. Run "Command Prompt" as administrator.

  2. Delete the existing route with ROUTE DELETE 0.0.0.0.

  3. ROUTE ADD 0.0.0.0 MASK 0.0.0.0 192.168.139.2 METRIC 1 Add a new default gateway with the command.

  4. Now check if the ping to ping 192.168.139.2 is working properly.