Skip to content

Download DVFS Client

Download the official standalone executable binary for the Distributed Virtual File System (DVFS) Client.

1. Direct Binary Downloads by Operating System

Select your operating system to download the standalone executable binary directly:

Windows (64-bit AMD64)

Edition Binary File Direct Download Link
Authenticated (Google Auth) dvfs-client-windows-amd64.exe Download dvfs-client-windows-amd64.exe
Offline / No-Auth dvfs-client-no-auth-windows-amd64.exe Download dvfs-client-no-auth-windows-amd64.exe

PowerShell Download & Run

Open PowerShell and run:

Invoke-WebRequest -Uri "https://github.com/DVFS-IIT-Gandhinagar/Distributed-Virtual-File-System/releases/latest/download/dvfs-client-windows-amd64.exe" -OutFile "dvfs.exe"
.\dvfs.exe --help

Windows SmartScreen Note: If Windows Defender prompts "Windows protected your PC", click More info → Run anyway.

macOS (Apple Silicon & Intel)

Architecture Binary File Direct Download Link
Apple Silicon (M1 / M2 / M3 / M4) dvfs-client-darwin-arm64 Download dvfs-client-darwin-arm64
Intel Macs (x86_64) dvfs-client-darwin-amd64 Download dvfs-client-darwin-amd64
No-Auth (Apple Silicon) dvfs-client-no-auth-darwin-arm64 Download dvfs-client-no-auth-darwin-arm64
No-Auth (Intel) dvfs-client-no-auth-darwin-amd64 Download dvfs-client-no-auth-darwin-amd64

Terminal 1-Line Download & Run

Open Terminal and run:

# For Apple Silicon (M1/M2/M3/M4):
curl -fsSL -o /usr/local/bin/dvfs https://github.com/DVFS-IIT-Gandhinagar/Distributed-Virtual-File-System/releases/latest/download/dvfs-client-darwin-arm64
chmod +x /usr/local/bin/dvfs

# Verify installation
dvfs --help

Gatekeeper Note: If macOS displays an alert saying the developer cannot be verified, clear the quarantine attribute: 

xattr -d com.apple.quarantine /usr/local/bin/dvfs

Linux (x86_64 & ARM64)

Architecture Binary File Direct Download Link
Linux x86_64 (AMD64) dvfs-client-linux-amd64 Download dvfs-client-linux-amd64
Linux ARM64 (Raspberry Pi 4/5 / Graviton) dvfs-client-linux-arm64 Download dvfs-client-linux-arm64
No-Auth Linux AMD64 dvfs-client-no-auth-linux-amd64 Download dvfs-client-no-auth-linux-amd64
No-Auth Linux ARM64 dvfs-client-no-auth-linux-arm64 Download dvfs-client-no-auth-linux-arm64

Terminal 1-Line Download & Run

# Download binary directly into /usr/local/bin
sudo curl -fsSL -o /usr/local/bin/dvfs https://github.com/DVFS-IIT-Gandhinagar/Distributed-Virtual-File-System/releases/latest/download/dvfs-client-linux-amd64
sudo chmod +x /usr/local/bin/dvfs

# Verify installation
dvfs --help

2. Authenticated Client vs No-Auth Client

We provide two standalone executable flavors with every release:

Feature Authenticated Client (Default) No-Auth Client (-no-auth)
Authentication Flow Google OAuth 2.0 (RFC 7636 PKCE) Bypass / Plain Username
Institutional Email Support Yes (IITGN or any Google domain) No
Server-Side Token Verification Cryptographically verified ID tokens Mock / unverified identities
Zero-Trust TLS / mTLS Full TLS 1.3 encryption Full TLS 1.3 encryption
Recommended Use Case Production & all end users Offline testing & CI benchmarking

3. First Run & Login

Step 1: Run the Executable

# Connect to cluster
./dvfs

Step 2: Google Sign-In

When prompted in your terminal: 

=========================================================
       Distributed Virtual File System (DVFS)
            Google Authentication Required
=========================================================
Enter your email: your_name@iitgn.ac.in

Please open the following URL in your web browser to sign in:
─────────────────────────────────────────────────────────
https://accounts.google.com/o/oauth2/v2/auth?client_id=...
─────────────────────────────────────────────────────────

  1. Open the generated URL in your browser.
  2. Sign in with your Google account.
  3. Your browser will redirect to http://localhost:38485/logincallback with Google Authentication Successful.
  4. Copy the displayed ID token and paste it into the terminal prompt.
  5. You are logged in! The session token is cached for subsequent commands.

4. Verifying Checksums

To verify binary integrity against our official SHA256 checksums:

  1. Download checksums: 
    curl -fsSL -O https://github.com/DVFS-IIT-Gandhinagar/Distributed-Virtual-File-System/releases/latest/download/SHA256SUMS.txt
  2. Verify:
  3. Linux / macOS: 
    sha256sum -c SHA256SUMS.txt --ignore-missing
  4. Windows (PowerShell): 
    Get-FileHash dvfs-client-windows-amd64.exe -Algorithm SHA256

5. Next Steps