DrUm78 5cf1d247f4 - Commented several empty sections in mkdocs.yml (will reactivate them later if someone fills them)
- Enabled 'Directory Structure' section that was not present in mkdocs.yml
- Removed all links to empty sections
- Fixed incorrect links that led to a 404 error
- Updated art covers url
- Redirected former FunKey OS links to my release page
- Updated a few things in some sections
- Fixed a few typos
2023-05-24 16:35:06 +02:00

1.7 KiB

On a Physical Machine / In a Virtual Machine

You may now build your FunKey with:

$ make

This may take a while (~30 minutes), so consider getting yourself a cup, a glass or a bottle of your favorite beverage ;-)

Note: you will need to have access to the network, since buildroot will download the package sources.

After building, you should obtain the SD Card image FunKey-sdcard-X.Y.Z.img, the SDK file FunKey-sdk-X.Y.Z.tar.gz and the firmware update file FunKey-rootfs-X.Y.fwu in the images directory.

In a Docker Container

You may now build your FunKey with:

$ docker run --name funkey-os funkeyproject/funkey-os

Or alternatively, you can run it in the background with:

$ docker run -d --name funkey-os funkeyproject/funkey-os

If you launch it in the background, you can still follow what is going on with either:

$ docker top funkey-os

Or:

$ docker logs funkey-os

This may take a while (~1h30), so consider getting yourself a cup, a glass or a bottle of your favorite beverage ;-)

Note: you will need to have access to the network, since buildroot will download the package sources.

After building, you can copy the SD Card image sdcard.img, the SDK file FunKey-sdk-X.Y.tar.gz and the firmware update file FunKey-rootfs-X.Y.fwu from the container into the host current directory:

$ mkdir images
$ docker cp funkey-os:/home/funkey/FunKey-OS/images/FunKey-sdcard-X.Y.Z.img images/
$ docker cp funkey-os:/home/funkey/FunKey-OS/images/FunKey-sdk-X.Y.Z.tar.gz images/
$ docker cp funkey-os:/home/funkey/FunKey-OS/images/FunKey-rootfs-X.Y.Z.fwu images/

--8<-- includes/glossary.md --8<--