Are there any plans to support riscv?

[lampra1]

Ask a Question!

I am on visionfive2, ubuntu 23.10 with a docker installation (Docker version 24.0.5, build 24.0.5-0ubuntu1).
Are there any plans to support riscv64 architecture?
Currently, I get the following when trying to run portainer ce:

Unable to find image 'portainer/portainer-ee:latest' locally
latest: Pulling from portainer/portainer-ee
docker: no matching manifest for linux/riscv64 in the manifest list entries.
See 'docker run --help'.

[Nick-Portainer]

Hi @lampra1, thanks for the question. I will raise this for a discussion with the team and let you know what feedback I get.

[josemanimala]

I managed to get the portainer agent to compile and run on riscv.
I have documented the steps in the issue here, portainer/agent#737.

[lampra1]

Hey @josemanimala thank you for the documentation.
I am not very familiar with building, but I tried to follow your steps.
I am on

OS: Debian GNU/Linux 13 (trixie) riscv64
Host: StarFive VisionFive 2 v1.3B
Kernel: Linux 6.12.57+deb13-riscv64
Packages: 345 (dpkg)
Shell: bash 5.2.37

$ sudo apt install docker.io
docker.io is already the newest version (26.1.5+dfsg1-9+b9).
$ sudo apt update
Hit:1 http://deb.debian.org/debian trixie InRelease
Hit:2 http://deb.debian.org/debian trixie-updates InRelease
Hit:3 http://security.debian.org/debian-security trixie-security InRelease
Get:4 https://download.docker.com/linux/debian trixie InRelease [32.5 kB]
Fetched 32.5 kB in 0s (72.5 kB/s)
All packages are up to date.
Notice: Skipping acquire of configured file 'stable/binary-riscv64/Packages' as repository 'https://download.docker.com/linux/debian trixie InRelease' doesn't support architecture 'riscv64'

It is not clear to me if you run the make all command in the agent or in the server-ce folder.
I tried both.
In the server-ce folder, it complains about yarn.

server-ce$ make all
Checking and downloading binaries for docker v29.1.2
Docker binary already exists, skipping download.
yarn
make: yarn: No such file or directory
make: *** [Makefile:42: client-deps] Error 127

Here is what I get in the agent folder:

agent$ make all
Credential helper already exists, skipping build.
healthy already exists, skipping build.
Checking and downloading binaries for docker v29.1.2
Downloading docker binary...
mkdir: created directory '.tmp/download'
--2025-12-11 20:17:49--  https://download.docker.com/linux/static/stable/riscv64/docker-29.1.2.tgz
Resolving download.docker.com (download.docker.com)... 13.225.35.126, 13.225.35.103, 13.225.35.77, ...
Connecting to download.docker.com (download.docker.com)|13.225.35.126|:443... connected.
HTTP request sent, awaiting response... 404 Not Found
2025-12-11 20:17:50 ERROR 404: Not Found.

make: *** [Makefile:49: download-binaries] Error 8

Do you have any recommendation?

[josemanimala]

My bad @lampra1. There was a step missing and I have added it.
The make all and docker binary check should be run in the agent folder.

[lampra1]

Thank you, @josemanimala
I am now successfully running the agent.
For reference, here is the sequence of your commands.
All but the first command are run in the agent/ folder

$ git clone https://github.com/portainer/agent.git
$ cd agent/
$ apt install golang-go docker.io mockgen
$ git clone https://github.com/portainer/portainer.git server-ce
$ which docker
$ cp /usr/bin/docker dist/
$ make all
$ cp build/linux/alpine.Dockerfile Dockerfile
$ docker build -t portainer-agent:latest .
$ docker run -d   -p 9001:9001   --name portainer_agent   --restart=always   -v /var/run/docker.sock:/var/run/docker.sock   -v /var/lib/docker/volumes:/var/lib/docker/volumes   -v /:/host   portainer-agent:latest

[josemanimala]

Excellent and great to hear that building the agent works.
I was able to get immich running through custom compilation.
So there is merit to building the agent ourselves.