|
| 1 | +--- |
| 2 | +title: Getting Started with Infix |
| 3 | +author: troglobit |
| 4 | +date: 2024-09-14 12:11:00 +0100 |
| 5 | +categories: [howto] |
| 6 | +tags: [beginner] |
| 7 | +pin: true |
| 8 | +--- |
| 9 | + |
| 10 | +This is a guide for those who want to learn more about Infix using a |
| 11 | +hands-on approach. You need a Linux 🐧 system with Qemu installed, we |
| 12 | +recommend [Debian][] based systems, like [Ubuntu][] and [Linux Mint][]. |
| 13 | + |
| 14 | +> For a pain-free experience we recommend enabling CPU virtualization in |
| 15 | +> your BIOS/UEFI, which for many computers is disabled by default. |
| 16 | +
|
| 17 | +From this point we assume you have your x86_64/AMD64 based Linux system |
| 18 | +up and running. Time to start your favorite terminal application! 😃 |
| 19 | + |
| 20 | + |
| 21 | +### Installing Qemu |
| 22 | + |
| 23 | +```bash |
| 24 | +$ sudo apt install qemu-system-x86 virt-manager |
| 25 | +``` |
| 26 | + |
| 27 | +### Download Infix |
| 28 | + |
| 29 | +Go to https://github.com/kernelkit/infix/releases/latest and scroll down |
| 30 | +to *Assets*. Download the tarball named `infix-x86_64-VERSION.tar.gz`, |
| 31 | +where VERSION is the year+month+patch release number. |
| 32 | + |
| 33 | +It extracts to a subdirectory: |
| 34 | + |
| 35 | + |
| 36 | +```bash |
| 37 | +$ sudo apt install qemu-system-x86 virt-manager |
| 38 | +``` |
| 39 | + |
| 40 | + |
| 41 | +### Running Infix |
| 42 | + |
| 43 | +> Depending on how you have [set up your Linux][sudo] installation, the |
| 44 | +> following may require being run with superuser privileges, i.e., you |
| 45 | +> may need to prepend the command with `sudo`. |
| 46 | +
|
| 47 | +For more Ethernet ports in your emulated system you need to change the |
| 48 | +Qemu configuration used for Infix. This can be done using a menuconfig |
| 49 | +interface, which requires the following extra package: |
| 50 | + |
| 51 | +```bash |
| 52 | +$ sudo apt install kconfig-frontends |
| 53 | +``` |
| 54 | + |
| 55 | +We can now enter the configuration: |
| 56 | + |
| 57 | +```bash |
| 58 | +$ ./qemu.sh -c |
| 59 | +``` |
| 60 | + |
| 61 | +Go down to *Networking*, select *TAP*, now you can change the *Number of |
| 62 | +TAPs*, e.g. to 10. Exit and save the configuration, then you can start |
| 63 | +Qemu again: |
| 64 | + |
| 65 | + ./qemu.sh |
| 66 | + |
| 67 | +> Make sure to do a factory reset from the CLI, otherwise you will be |
| 68 | +> stuck with that single interface from before. |
| 69 | +
|
| 70 | +[sudo]: https://troglobit.com/2016/12/11/a-life-without-sudo/ |
| 71 | +[Debian]: https://www.debian.org/ |
| 72 | +[Ubuntu]: https://ubuntu.com/ |
| 73 | +[Linux Mint]: https://linuxmint.com/ |
0 commit comments