This directory contains the Bun runtime on Unikraft, in binary compatibility mode. It implements a simple server running on Unikraft that provides a simple response to each request.
Use kraft
to run the image and start a Unikraft instance:
kraft run --rm -M 512M -p 3000:3000 --plat qemu --arch x86_64 unikraft.org/bun:1.1
If the --plat
argument is left out, it defaults to qemu
.
If the --arch
argument is left out, it defaults to your system's CPU architecture.
Once executed, it will open port 3000
and wait for connections.
To test it, you can use curl
:
curl localhost:3000
You should see a "Hello, World!" message.
To list information about the Unikraft instance, use:
kraft ps
NAME KERNEL ARGS CREATED STATUS MEM PORTS PLAT
eloquent_nyota project://bun:qemu/x86_64 /usr/bin/bun run /usr/src/server.ts 8 seconds ago running 0MiB 0.0.0.0:3000->3000/tcp qemu/x86_64
The instance name is eloquent_nyota
.
To close the Unikraft instance, close the kraft
process (e.g., via Ctrl+c
) or run:
kraft rm eloquent_nyota
The commands so far used the pre-build Bun image available in the Unikraft registry.
In oder to to build a local Bun image, clone this repository and cd
into this directory.
Then use kraft
to build an image locally:
kraft build --no-cache --no-update --plat qemu --arch x86_64
Similar to the kraft run
command, if the --plat
argument is left out, it defaults to qemu
.
If the --arch
argument is left out, it defaults to your system's CPU architecture.
In order to run the locally built image, use .
(dot, the current directory) as the final argument to the kraft run
command:
kraft run --rm -M 512M -p 3000:3000 --plat qemu --arch x86_64 .
Same as above, it will open port 3000
and wait for connections.
Mixing invocations of kraft
and sudo
can lead to unexpected behavior.
Read more about how to start kraft
without sudo
at https://unikraft.org/sudoless.