zVault.io build guide

[matheusber]

Hi,

is this the last version of the guide?

I am trying to build here for ARM64 and I get some errors linking to what looks to me (I may be wrong, sure) "freenas" related code/config:

• FileNotFoundError: [Errno 2] No such file or directory: '/local/zvaultio/zvio-build/build/profiles/freenas/config.pyd'
  In the guid, there is the line: "Modify ./build/profiles/zvault/repos.pyd and update the URL to the URL of your gitea instance."
  But the path has a freenas folder, not the zvault. I changed to zvault but got that error. I then tried to symlink one to another, and then I copied them to look just the same content. In the end I copied the freenas to zvault and they have the same files inside.

• "make checkout zvault" works the first target, the second one renders this:

make[1]: don't know how to make zvault. Stop

make[1]: stopped in /local/zvaultio/zvio-build
*** Error code 2

Stop.
make: stopped in /local/zvaultio/zvio-build

If I try make freenas instead:

root@zvault:/local/zvaultio/zvio-build # make freenas
[0:00:00] ==> NOTICE: Selected profile: freenas
[0:00:00] ==> NOTICE: Build timestamp: 202508031210
[0:00:01] ==> Checking build environment...
[0:00:01] ==> Build environment is OK
[0:00:01] ==> Sandbox is fully checked out
`freenas' is up to date.

make zvault does not :(

root@zvault:/local/zvaultio/zvio-build # make zvault
[0:00:00] ==> NOTICE: Selected profile: freenas
[0:00:00] ==> NOTICE: Build timestamp: 202508031210
[0:00:00] ==> Checking build environment...
[0:00:00] ==> Build environment is OK
[0:00:00] ==> Sandbox is fully checked out
make[1]: don't know how to make zvault. Stop

make[1]: stopped in /local/zvaultio/zvio-build
*** Error code 2

Stop.
make: stopped in /local/zvaultio/zvio-build

The checkout is ok, I presume:

root@zvault:/local/zvaultio/zvio-build # make checkout
[0:00:00] ==> NOTICE: Selected profile: freenas
[0:00:00] ==> NOTICE: Build timestamp: 202508031210
[0:00:00] ==> Checking build environment...
[0:00:00] ==> Build environment is OK
[0:00:00] ==> Checkout: os -> zvio-os
Current branch zvio-13.3 is up to date.
[0:00:00] ==> Checkout: freenas -> zvio-middleware
Current branch zvio-13.3 is up to date.
[0:00:00] ==> Checkout: webui -> zvio-webui
Current branch zvio-13.3 is up to date.
[0:00:01] ==> Checkout: ports -> zvio-ports
Current branch zvio-13.3 is up to date.
[0:00:01] ==> Checkout: py-licenselib -> zvio-py-licenselib
Current branch zvio-13.3 is up to date.
[0:00:01] ==> Checkout: freenas-pkgtools -> zvio-pkgtools
Current branch zvio-13.3 is up to date.
[0:00:01] ==> Checkout: py-bsd -> zvio-py-bsd
Current branch zvio-13.3 is up to date.
[0:00:01] ==> Checkout: iocage -> zvio-iocage
Current branch zvio-13.3 is up to date.
[0:00:01] ==> Updating Release Information
root@zvault:/local/zvaultio/zvio-build # 

I followed the guide so far, I have gitea installed and configured here as told.

My box is:
FreeBSD zvault 13.5-RELEASE FreeBSD 13.5-RELEASE releng/13.5-n259162-882b9f3f2218 GENERIC arm64

I am not a dev person, and I am in the first steps trying things here, so I may be very wrong. But it looks to me as I need to change a target that says freenas to zvault somewhere. Am I too much wrong?

Thanks and congratulations for the great work, FreeNAS was a great product and you are heroes to make it live. I hope I can help you

matheus

[derzahla]

are you using the zvio-13.3 branch of zvio-build?

[matheusber]

are you using the zvio-13.3 branch of zvio-build?

Hi,

I will double check, but the zvio-build I am quite sure, the others I will check again.
When I checkout zvio-build and change it to the zvio-13.3 tag, do I need to change the others or it checks them at right version?

Anyway I will look into this.

Thanks!

[derzahla]

i dont know. im just monkeying around trying to build against freebsd 14.3. But I know I have zvio-build/build/profiles/zvault in mine, but its not present on the master branch

[matheusber]

i dont know. im just monkeying around trying to build against freebsd 14.3. But I know I have zvio-build/build/profiles/zvault in mine, but its not present on the master branch

Good to know, mine has not the zvault profile. And I have changed to branch:

root@zvault:/local/zvaultio/zvio-build # git checkout -b zvio-13.3
fatal: a branch named 'zvio-13.3' already exists

The other repositories they are on zvio-13.3, the repos.pyd has the right branch.

[derzahla]

you arent on zvio-13.3 branch from that command. 'git checkout zvio-13.3'

[derzahla]

probably best to just remove and reclone the whole repo. if you wanna see what branch you are on you run 'git branch'. if you want to switch to a branch you run 'git checkout '. no '-b'

[matheusber]

Guess what, you were right. The code was not on the right branch. That is fixed now, and I got further in the process for building for arm64. Now I got a kernel issue I will look into later today.

Thanks!

[derzahla]

ixnvdimm?:) I gave up on 14 for now and just trying to get a build 13.5 - I really wish @zvaultio would make their work public since they already have a 13.5 build if not a 14 build.

[derzahla]

Any luck? This project seems already dead

[matheusber]

Well, I sent a question on the other thread but I guess its answered here. where was the point it failed?

Here it is building yet the ports, but I got these messages that worry:

[07:14:37] [02] [00:11:11] Saving freenas/zvio-py-fenced@py39 | py39-fenced-0.1.2 wrkdir
[07:14:37] [02] [00:11:11] Saved freenas/zvio-py-fenced@py39 | py39-fenced-0.1.2 wrkdir to: /local/zvaultio/zvio-build/zvault/_BE/objs/ports/data/wrkdirs/ja-p/p/py39-fenced-0.1.2.tbz
[07:14:37] [02] [00:11:11] Finished   freenas/zvio-py-fenced@py39 | py39-fenced-0.1.2: Failed: configure
[07:14:37] [02] [00:11:11] Skipping   freenas/freenas-files | freenas-files-13.3_1746400833: Dependent port freenas/zvio-py-fenced@py39 | py39-fenced-0.1.2 failed
[07:14:37] [02] [00:11:11] Skipping   freenas/py-midcli@py39 | py39-midcli-20190509171453: Dependent port freenas/zvio-py-fenced@py39 | py39-fenced-0.1.2 failed
[07:14:37] [02] [00:11:11] Skipping   freenas/py-middlewared@py39 | py39-middlewared-13.3_1746400833: Dependent port freenas/zvio-py-fenced@py39 | py39-fenced-0.1.2 failed

Have you seen this?

Here this is the current status:

       Queued: 692 Inspected: 0 Ignored: 0 Built: 495 Failed: 1 Skipped: 3 Fetched: 0 Remaining: 193

[matheusber]

Well, almost there:

[02:15:00] Built ports: x11-fonts/dejavu www/yarn x11-fonts/xorg-fonts-truetype sysutils/arcconf www/npm-node18 devel/py-dbus@py39 math/suitesparse-colamd net-mgmt/py-pysnmp@py39 net/avahi-app security/py-paramiko@py39 net/netatalk3 sysutils/py-zettarepl@py39 net/libvncserver devel/libhyve-remote math/suitesparse-cholmod x11-toolkits/pango sysutils/nut security/py-openssl@py39 www/py-aiohttp@py39 security/py-asyncssh@py39 dns/py-dns-lexicon@py39 security/py-google-auth@py39 math/suitesparse-umfpack databases/rrdtool net/samba www/py-aiohttp-wsgi@py39 security/py-josepy@py39 www/py-google-api-core@py39 security/py-google-auth-httplib2@py39 security/py-acme@py39 graphics/gpu-firmware-amd-kmod@polaris11 net-mgmt/collectd5 graphics/gpu-firmware-radeon-kmod@r700 math/py-numpy@py39 graphics/gpu-firmware-kmod graphics/drm-kmod www/py-google-api-python-client@py39 www/npm devel/py-magic@py39 devel/py-parsedatetime@py39 www/novnc-websockify www/wgetpaste net/py-s3cmd@py39 misc/e2fsprogs-libuuid sysutils/fusefs-ntfs freenas/swagger-ui devel/libcbor misc/e2fsprogs-libblkid security/py-certbot@py39 sysutils/grub2-x86_64-efi sysutils/syslog-ng security/libfido2 security/py-certbot-dns-digitalocean@py39 sysutils/e2fsprogs-core security/openssh-portable@default sysutils/e2fsprogs security/py-certbot-dns-ovh@py39 security/py-certbot-dns-google@py39 security/py-certbot-dns-cloudflare@py39
[02:15:00] Failed ports: freenas/zvio-py-fenced@py39:configure freenas/freenas-webui:fetch
[02:15:00] Skipped ports: freenas/freenas-files freenas/py-midcli@py39 freenas/py-middlewared@py39
[02:15:00] [ja-p] [2025-08-15_07h40m03s] [committing] Time: 02:13:06
           Queued: 64 Inspected: 0 Ignored: 0 Built: 59 Failed: 2 Skipped: 3 Fetched: 0 Remaining: 0
[02:15:00] Logs: /local/zvaultio/zvio-build/zvault/_BE/objs/ports/data/logs/bulk/ja-p/2025-08-15_07h40m03s
[02:15:00] Cleaning up
[02:15:00] Unmounting file systems
[2:35:11] ==> ERROR: Ports build failed
[2:35:11] ==> Cleaning up poudriere environment...
[2:35:11] ==> Unmounting ports overlay...
*** Error code 1

Stop.
make[2]: stopped in /local/zvaultio/zvio-build
*** Error code 1

Stop.
make[1]: stopped in /local/zvaultio/zvio-build
*** Error code 1

Stop.
make: stopped in /local/zvaultio/zvio-build

If anyone have any hints here.

@derzahla I will work on putting together the scripts to get here and publish on github, but spoiler alert: just some scripts to issue the commands on the guide :)

[matheusber]

https://github.com/matheusber/zvault

[derzahla]

zvio-middleware/nas_ports/freenas/zvio-py-fenced/Makefile needs:
WRKSRC=/usr/nas_source/zvio-py-fenced
changed back to:
WRKSRC=/usr/nas_source/fenced
i think

oh so you are also stuck on py-libzfs - i was hoping you had found a solution:( my build system is really not adequate for this, very slow

edit: actually I don't think py-fenced is even be used for truenas core, its not HA