Quickstart

Add your first files and watch the Merkle tree update live.

This walks you from a fresh install to a live, fingerprinted file tree. It assumes you've already installed the node.

Open the web UI#

After the installer finishes it prints two addresses:

shell

▲ OneSVD  WebUI ready

  - Local:    http://localhost:7777
  - Network:  http://192.168.1.42:7777

Open the local URL on the same machine, or the network URL from another device on your LAN.

Add a file#

The watcher monitors your watched directory — the one you chose at install. Not sure where that is? onesvd dir prints it. Drop a file in:

shell

echo "hello onesvd" > "$(onesvd dir)/readme.txt"

Within a moment the UI shows the new file, its size, and its SHA-256 fingerprint. The root hash in the top bar changes too — because the contents of the tree changed, its fingerprint did.

You can also drag files straight into the browser, or use the upload button. Large files upload in resumable chunks, so a dropped connection doesn't mean starting over.

Watch the tree recompute#

Change the file and watch the fingerprints cascade:

shell

echo "hello again" >> "$(onesvd dir)/readme.txt"

The file's hash updates, and so does every folder above it up to the root. That cascade is the whole point — a change anywhere shows at the top.

See the Merkle graph#

Click the root fingerprint in the top bar to open the Merkle graph: an animated view of the tree with every node's hash. You can search, zoom, and copy any hash. It's the clearest way to see content addressing at work.

Next#

Configuration — point the watcher at a different directory, change ports, set a token.
Git runners — auto-build a repo into your tree on every commit.
The Merkle tree — what those hashes mean.