Using prebuilt linuxsdk docker image

[fanghuaqi]

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

[fanghuaqi]

In this docker image, SOC=demosoc CORE=ux600 is default prebuilt with freeloader and bootimages, you can directly use it, Nuclei QEMU is also installed, but Nuclei OpenOCD is not installed.

2023.11.24 -> For latest image, it use the default config in Makefile.

[fanghuaqi]

Since 2023.11.23, branch dev_nuclei_5.10/dev_nuclei_5.10_v2/dev_nuclei_6.1/dev_nuclei_6.1_v2 are enabled with docker image support, docker tag is the branch name, eg. for branch dev_nuclei_5.10, the docker image is nucleisoftware/linuxsdk:dev_nuclei_5.10

[fanghuaqi]

Since 2023.11.27, the prebuilt docker image(ci generated) for branch dev_nuclei_5.10/dev_nuclei_5.10_v2/dev_nuclei_6.1/dev_nuclei_6.1_v2/dev_nuclei_next size decreased from near 8G to about 2G, this decrease is caused by the linux sdk source code in these images are shallow cloned(with --depth 10), if you want to pull the complete source code, you need to run git fetch --unshallow, but it will cost time and may fail depending on your network to github.

Note: now in these images, gitee remote is remoted due to gitee mirror is now not working, see #10 (comment)

[fanghuaqi]

Since 2023.12.20, the prebuilt docker image(ci generated) for branch dev_nuclei_6.6_v2 using gcc13 is pushed to https://hub.docker.com/r/nucleisoftware/linuxsdk , tag dev_nuclei_6.6_v2

[fanghuaqi]

Docker hub mirror see https://gist.github.com/y0ngb1n/7e8f16af3242c7815e7ca2f0833d3ea6

gist.github.com 无法访问问题，请自行百度解决

screenhost of above link content @ 2023.12.22

[sunao2002002]

What is the password for nuclei when using the docker image?

[fanghuaqi]

What is the password for nuclei when using the docker image?

# In docker now, user/pwd: nuclei/riscv123