Skip to content

khadas/fenix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

6546228 · Mar 28, 2025
May 21, 2024
Mar 17, 2025
Mar 18, 2025
Aug 24, 2021
Jun 20, 2024
Mar 27, 2025
Sep 14, 2024
Jun 27, 2018
Apr 14, 2021
Dec 23, 2024
Mar 2, 2018
Jul 25, 2024
Nov 29, 2024
Jun 22, 2020
Nov 7, 2020

Repository files navigation

Build Download

Fenix script set to build Ubuntu/Debian images

Documentation Licence Version PRs Welcome

Supported build host:

  • Ubuntu 22.04 x64
    • Building Ubuntu 22.04 image
    • Building Ubuntu 24.04 image
    • Building Debian 12 image
  • Docker

How to use

Install essential packages

$ sudo apt-get install git make lsb-release qemu-user-static

Clone Fenix repository

$ mkdir -p ~/project/khadas
$ cd ~/project/khadas
$ git clone --depth 1 https://github.com/khadas/fenix
$ cd fenix

Setup build environment

  • Setup environment manually.
$ source env/setenv.sh
  • Or you can load environment configuration from file.
$ source env/setenv.sh config config-template.conf

You need to edit config-template.conf file to correct variables.

Build image

$ make

For Chinese users, it's better to use mirror from China:

$ DOWNLOAD_MIRROR=china make

Somethings with Redhat series

Disable SELinux

$ vim /etc/selinux/config
$ SELINUX=enforcing --> SELINUX=disabled
$ sudo reboot

Build in Docker

Get Docker image

$ cd fenix
$ docker pull numbqq/fenix:latest

Build image in Docker

Run fenix in docker.

$ docker run -it --name fenix -v $(pwd):/home/khadas/fenix \
             -v /etc/localtime:/etc/localtime:ro \
             -v /etc/timezone:/etc/timezone:ro \
             -v $HOME/.ccache:/home/khadas/.ccache --privileged \
             --device=/dev/loop-control:/dev/loop-control \
             --device=/dev/loop0:/dev/loop0 --cap-add SYS_ADMIN \
             numbqq/fenix

We are in Docker container now, start to build.

khadas@919cab43f66d:~/fenix$ source env/setenv.sh
khadas@919cab43f66d:~/fenix$ make

For Chinese users, it's better to use mirror from China:

khadas@919cab43f66d:~/fenix$ DOWNLOAD_MIRROR=china make

To restart the Docker container a second time.

$ docker start fenix
$ docker exec -ti fenix bash