search

KatharaFramework / Kathara

A lightweight container-based network emulation system.
https://www.kathara.org/
GNU General Public License v3.0
452 stars 63 forks source link

How to run Katharà on Apple M1 #140

Closed tcaiazzi closed 2 years ago

tcaiazzi commented 3 years ago

Describe the bug Kathará does not work correctly on Apple devices with M1 processor.

To Reproduce Steps to reproduce the behavior:

  1. Install Kathará on a Apple device with M1 processor.
  2. Run a device or a scenario with at least 1 collision domain.
  3. Obtain the following error: image

Expected behavior Kathará should work correctly.

tcaiazzi commented 3 years ago

Unfortunately, an official release for M1 processors is still under development. However, the Docker images and the Network Plugin are ready, so waiting for an official release, it is still possible to use Kathará.

Solution You have to perform the following steps:

  1. Open a terminal.
  2. If present, uninstall the old Docker Network Plugin for x86:
    • docker plugin rm -f kathara/katharanp:latest.
  3. Clone the Kathará Network Plugin repository:
    • git clone https://github.com/KatharaFramework/NetworkPlugin.git
  4. Enter the Network Plugin directory and open the Makefile with a text editor.
  5. Change line 38 of the Makefile:
    • From: docker plugin create ${PLUGIN_NAME}:$* ./plugin-src/
    • To: docker plugin create ${PLUGIN_NAME}:latest ./plugin-src/
  6. From the terminal, run the Makefile with:
    • make all_arm64
  7. Now, if you have Kathará already installed then it should work. Otherwise, install it (Installation Guide).
oliverjamarie commented 2 years ago

Thank you! I've been having to work with slow Virtual Machines for 2 months!

tcaiazzi commented 2 years ago

Finally we officially release a Kathará version (3.3.0) supporting Apple M1 processors! Check the release page.