https://github.com/progrium/wtux

Minimal i386 Linux for Wanix/v86
https://github.com/progrium/wtux

9p busybox i386 linux v86 wanix

Last synced: 3 months ago
JSON representation

Minimal i386 Linux for Wanix/v86

• Host: GitHub
• URL: https://github.com/progrium/wtux
• Owner: progrium
• License: mit
• Archived: true
• Created: 2025-01-31T08:03:13.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-04T05:06:27.000Z (over 1 year ago)
• Last Synced: 2026-04-25T06:35:37.568Z (3 months ago)
• Topics: 9p, busybox, i386, linux, v86, wanix
• Language: JavaScript
• Homepage:
• Size: 50.8 KB
• Stars: 5
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# wtux

Minimal i386 Linux distro for Wanix/v86

## Prerequisites 

* make

* Docker (build on any platform)

* QEMU (for testing)

* python3 (for http)

## Building

```sh

make distro

```

This uses Docker to produce a kernel and initramfs in `./output` which together should be about 3MB. Would love to make this even smaller.

## Testing with QEMU

```sh

make qemu

```

This will run QEMU using the files in `./output`. 

## Testing with v86

First build v86 files. This only needs to be done once:

```sh

make v86

```

Now start an HTTP server. This make task uses python3:

```sh

make serve

```

Now browse to `http://localhost:8000`.

## Source

* Kernel config is in `kernel.config`

* Kernel and busybox are built in `Dockerfile`

* Init script is defined in `init`