Private Drive

Every Nomad user has a private drive — your personal on-device storage, created automatically on first launch and persisted across sessions. It holds data that should live on your machine, like bookmarks and app preferences.

Like every drive in Nomad it is an Autobase, reached through the single nomad.fs API. What makes it special is only that it is addressed by the well-known URL hyper://private/ and is not published to the public network.

Accessing the private drive

Navigate to it directly in the address bar:

hyper://private/

Or from JavaScript with nomad.fs:

var privateDrive = nomad.fs.drive('hyper://private/')

// read a file
var data = await privateDrive.readFile('/my-notes.txt')

// write a file
await privateDrive.writeFile('/my-notes.txt', 'Hello, private world!')

// list files
var entries = await privateDrive.readdir('/')

Properties

Common uses

The private drive is a good place to store:

• Personal notes and drafts
• Bookmarks and pins (/bookmarks/, /nomad/pins.json)
• App configuration and preferences
• Data created by nomad:// pages that needs to persist across sessions

// check that hyper://private/ is writable
var info = await nomad.fs.getInfo('hyper://private/')
console.log(info.writable) // true