Skip to content

Add ZFS-FUSE setup instructions for browser development #268

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
NikolayS wants to merge 2 commits into from
Closed

Add ZFS-FUSE setup instructions for browser development #268

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1f9dc9d
Add ZFS-FUSE setup instructions for browser development
claude Dec 28, 2025
a282020
Remove --force from GitLab mirror push
claude Dec 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/mirror-to-gitlab.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,6 @@ jobs:
# Push the current branch
BRANCH_NAME="${GITHUB_REF#refs/heads/}"
echo "Pushing branch: ${BRANCH_NAME}"
git push gitlab "HEAD:refs/heads/${BRANCH_NAME}" --force
git push gitlab "HEAD:refs/heads/${BRANCH_NAME}"

echo "Successfully mirrored to GitLab"
3 changes: 3 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
1.1. **Entry Points** (`cmd/`)
2. **Frontend code** (`ui/`)

## Development Environment
For ZFS-FUSE setup in Claude Code browser environment, see CONTRIBUTING.md ("ZFS-FUSE for Claude Code" section).

## Build/Test/Lint Commands
- Build all components: `cd engine && make build`
- Lint code: `cd engine && make run-lint`
Expand Down
22 changes: 22 additions & 0 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,28 @@ Components have a separate version, denoted by either:
```
- Install `golangci-lint`: https://github.com/golangci/golangci-lint#install

#### ZFS-FUSE for Claude Code (browser environment)
When developing in Claude Code's browser-based environment (gVisor sandbox), kernel ZFS modules are unavailable. Use ZFS-FUSE instead:

```bash
# Download packages from Debian (network to Ubuntu repos may be restricted)
mkdir -p /tmp/zfs-install && cd /tmp/zfs-install
curl -sLO "https://deb.debian.org/debian/pool/main/z/zfs-fuse/zfs-fuse_0.7.0-33_amd64.deb"
curl -sLO "https://deb.debian.org/debian/pool/main/f/fuse3/fuse3_3.17.2-3_amd64.deb"
curl -sLO "https://deb.debian.org/debian/pool/main/f/fuse3/libfuse3-4_3.17.2-3_amd64.deb"
curl -sLO "https://deb.debian.org/debian/pool/main/liba/libaio/libaio1t64_0.3.113-8+b1_amd64.deb"

# Install packages
sudo dpkg -i libaio1t64_*.deb libfuse3-4_*.deb fuse3_*.deb zfs-fuse_*.deb

# Start daemon and create a file-backed pool
sudo zfs-fuse -n &
truncate -s 500M /tmp/zfs-disk.img
sudo zpool create -f testpool /tmp/zfs-disk.img
```

Note: Pool/snapshot/clone operations work, but FUSE mounting may fail due to gVisor limitations. This is sufficient for testing ZFS metadata operations.

<!-- TODO: Linux specific requirements? MacOS specific? -->


Expand Down
Loading