visionfive2

Stock Ubuntu riscv64 Linux for the StarFive VisionFive 2

This stock Ubuntu riscv64 Linux image is built directly from official ports packages using the Debian debootstrap utility.

Being an unmodified ubuntu-ports build, patches are directory available from the Ubuntu repos using the stock apt package manager.

If you want to run out-of-the-box Ubuntu Linux on your StarFive VisionFive 2 riscv64 device, this is the way to do it.

---

ubuntu mantic setup

1. download image

wget https://github.com/inindev/visionfive2/releases/download/v23.10.0/visionfive2_mantic-v23.10.img.xz

2. determine the location of the target micro sd card

• before plugging-in device

ls -l /dev/sd*
ls: cannot access '/dev/sd*': No such file or directory

• after plugging-in device

ls -l /dev/sd*
brw-rw---- 1 root disk 8, 0 Apr 10 15:56 /dev/sda

• note: for mac, the device is /dev/rdiskX

3. in the case above, substitute 'a' for 'X' in the command below (for /dev/sda)

sudo sh -c 'xzcat visionfive2_mantic-v23.10.img.xz > /dev/sdX && sync'

when the micro sd has finished imaging, eject and use it to boot the visionfive2 to finish setup

4. login account

login id: ubuntu
password: ubuntu

5. take updates

sudo apt update
sudo apt upgrade

6. create account & login as new user

sudo adduser youruserid
echo '<youruserid> ALL=(ALL) NOPASSWD: ALL' | sudo tee /etc/sudoers.d/<youruserid>
sudo chmod 440 /etc/sudoers.d/<youruserid>

7. lockout and/or delete ubuntu account

sudo passwd -l ubuntu
sudo chsh -s /usr/sbin/nologin ubuntu

sudo deluser --remove-home ubuntu
sudo rm /etc/sudoers.d/ubuntu

8. change hostname (optional)

sudo nano /etc/hostname
sudo nano /etc/hosts

---

building ubuntu mantic riscv64 for the visionfive2 from scratch

The build script builds native riscv64 binaries, and thus needs to be run from an riscv64 device such as visionfive2 running a 64 bit risc-v linux.

1. clone the repo

git clone https://github.com/inindev/visionfive2.git
cd visionfive2

2. run the ubuntu build script

cd ubuntu
sudo sh make_ubuntu_img.sh

• note: edit the build script to change various options: nano make_ubuntu_img.sh

3. the output if the build completes successfully

mmc_4g.img.xz