We have prepared a linuxsdk docker image located in https://hub.docker.com/repository/docker/nucleisoftware/linuxsdk, you can use the docker image there, if you don't want to step the environment by yourself.

If you don't want to use docker, please following #4 to download code

The following branches are enabled with docker support:
Available tags: https://hub.docker.com/repository/docker/nucleisoftware/linuxsdk/tags

• dev_nuclei_next: nucleisoftware/linuxsdk:ci , later on it will be nucleisoftware/linuxsdk:dev_nuclei_next
• dev_nuclei_5.10/dev_nuclei_5.10_v2/dev_nuclei_6.1/dev_nuclei_6.1_v2/dev_nuclei_6.6_v2: docker tag is the branch name, eg. for branch dev_nuclei_5.10, the docker image is nucleisoftware/linuxsdk:dev_nuclei_5.10

NOTE For evaluating optee, see #13 , this docker image is uploaded by @fanghuaqi manually, not ci generated.

Recommended docker tags: dev_nuclei_5.10_v2, dev_nuclei_6.1_v2, dev_nuclei_6.6_v2

NOTE: not work for upload freeloader, you need to copy the freeloader to out side of docker, and program to flash using openocd and gdb by yourself, see https://github.com/Nuclei-Software/nuclei-linux-sdk/wiki/Program-freeloader

Sample steps:

1. Make sure your docker is installed in your linux environment, see https://docs.docker.com/engine/install/ubuntu/
2. Make sure you have good connection to docker hub, otherwise use mirror of docker hub, search it by yourself
   • docker.1ms.run 2025.06.10 可用
   • https://www.wangdu.site/course/2109.html
   • https://www.wxy97.com/archives/b5b225b6-7741-4560-be2f-2e6a4f671d9b
   • https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6
   • https://www.runoob.com/docker/docker-mirror-acceleration.html
   • https://segmentfault.com/a/1190000023117518
3. Use the docker image of linux sdk

# In Host
## if using docker hub mirror from docker.1ms.run , you can run like this
# docker run -it docker.1ms.run/nucleisoftware/linuxsdk:dev_nuclei_5.10_v2
# Here below just pull docker from official docker hub
docker run -it nucleisoftware/linuxsdk:dev_nuclei_5.10_v2
# In docker now, user/pwd: nuclei/riscv123
cd nuclei-linux-sdk
# build project just follow https://github.com/Nuclei-Software/nuclei-linux-sdk#show-help
# this linux sdk repo cloned in this docker image is not full clone
# if you want to update source code or checkout different branch, do it as you like