src/start.sh

#!/usr/bin/env bash
set -Eeuo pipefail

# Diagnostics: when DEBUG=Y or DIAG=Y, print environment info useful for
# debugging why KVM or networking may not be available in restricted hosts
# (e.g. Hugging Face Spaces).
if [[ "${DEBUG:-N}" == [Yy1]* || "${DIAG:-N}" == [Yy1]* ]]; then
	echo "--- startup diagnostics ---"
	echo "User UID: $(id -u) ($(id -un 2>/dev/null || echo unknown))"
	if [ -e /dev/kvm ]; then
		ls -l /dev/kvm || true
		if [ -w /dev/kvm ] 2>/dev/null; then
			echo "/dev/kvm: present and writable"
		else
			echo "/dev/kvm: present but not writable"
		fi
	else
		echo "/dev/kvm: missing"
	fi

	if [ -e /dev/net/tun ]; then
		ls -l /dev/net/tun || true
		echo "/dev/net/tun: present"
	else
		echo "/dev/net/tun: missing"
	fi

	if [ -e /dev/vhost-net ]; then
		ls -l /dev/vhost-net || true
		echo "/dev/vhost-net: present"
	else
		echo "/dev/vhost-net: missing"
	fi

	echo "Kernel accel availability (qemu):"
	if command -v qemu-system-x86_64 &>/dev/null; then
		qemu-system-x86_64 -accel help 2>/dev/null || true
	else
		echo "qemu-system-x86_64: not installed"
	fi
	echo "--- end diagnostics ---"
fi

# You can override this hook to execute a script before startup!

return 0