Filesystem

Local filesystem store for walkerOS server flows. Reads and writes files relative to a base directory with path traversal protection.

Setup

Install the package:

Configure in your code:

Add to your flow.json:

Property	Type	Description	More
`basePath*`	`string`	Root directory for file operations. All keys are resolved relative to this path.

* Required fields

get() returns Buffer for compatibility with the file transformer, which uses content instanceof Buffer for Content-Length calculation.

Use with the file transformer to serve static assets from the local filesystem:

A request to /static/walker.js reads ./public/walker.js from disk.

Path traversal protection: Requests with .., absolute paths, or backslash traversal are rejected and logged as warnings
Base path scoping: All operations are restricted to the configured basePath directory
Intermediate directories: set() creates parent directories automatically via mkdir -p

Scenario	Recommended store
Local development	Filesystem: files on disk, no credentials needed
Docker with baked-in assets	Filesystem: mount or copy files into the image
Cloud / managed deployments	S3: files in a bucket, hot-swappable
Caching / ephemeral data	Memory: fastest, no I/O

💡 Need implementation support?

elbwalker offers hands-on support: setup review, measurement planning, destination mapping, and live troubleshooting. Book a 2-hour session (€399)