⚠️ The Cartesi team keeps working internally on the next version of this repository, following its regular development roadmap. Whenever there's a new version ready or important fix, these are published to the public source tree as new releases.
The Cartesi Image RootFS is the repository that provides the Docker configuration files to build the rootfs.ext2
testing filesystem. This is used to run a Linux environment on the Cartesi Machine Emulator reference implementation. The current image is based on the cartesi/toolchain
that uses Ubuntu 20.04 and GNU GCC 9.3.0. The rootfs.ext2
is built with Buildroot 2020.05 targeting the RISC-V RV64IMA with ABI LP64 architecture.
- Docker 18.x
- GNU Make >= 3.81
$ make build
If you want to tag the image with custom name you can do the following:
$ make build TAG=mytag
To remove the generated images from your system, please refer to the Docker documentation.
The following options are available as make
targets:
- build: builds the docker rootfs image
- copy: builds the rootfs image and copy it's artifact to the host
- run: runs the generated image with current user UID and GID
- run-as-root: runs the generated image as root
- push: pushes the image to the registry repository
- submodules: updates the git submodules recusively
You can pass the following variables to the make target if you wish to use different docker image tags.
- TAG: image-roofs image tag
- TOOLCHAIN_TAG: toolchain image tag
$ make build TAG=mytag
$ make build TOOLCHAIN_TAG=mytag
It's also useful if you want to use pre-built images:
$ make run TAG=latest
The purpose of this image is to build the rootfs.ext2
artifact so it can be used with the emulator. For instructions on how to do that, please see the emulator documentation.
If you want to play around on the environment you can also do:
$ make run
Customizations are based on the br2-external mechanism. For more information read Buildroot documentation.
Thank you for your interest in Cartesi! Head over to our Contributing Guidelines for instructions on how to sign our Contributors Agreement and get started with Cartesi!
Please note we have a Code of Conduct, please follow it in all your interactions with the project.
- Diego Nehab
- Victor Fusco
The image-rootfs repository and all contributions are licensed under APACHE 2.0. Please review our LICENSE file.