https://github.com/heyputer/puter-fuse
Mount the Puter Internet Filesystem on Your Linux/Mac Device
https://github.com/heyputer/puter-fuse
filesystem fuse fuse-filesystem fuse-tools linux-filesystem puter
Last synced: 11 months ago
JSON representation
Mount the Puter Internet Filesystem on Your Linux/Mac Device
- Host: GitHub
- URL: https://github.com/heyputer/puter-fuse
- Owner: HeyPuter
- License: agpl-3.0
- Created: 2023-05-18T19:40:23.000Z (about 3 years ago)
- Default Branch: trunk
- Last Pushed: 2024-09-25T21:27:36.000Z (over 1 year ago)
- Last Synced: 2025-05-05T14:51:45.268Z (about 1 year ago)
- Topics: filesystem, fuse, fuse-filesystem, fuse-tools, linux-filesystem, puter
- Language: Go
- Homepage:
- Size: 342 KB
- Stars: 38
- Watchers: 4
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
FUSE Driver for the Puter Internet OS
Access Puter's filesystem on your device
## What does this do?
This program lets you mount your files from the [Puter Open-Source Internet OS](https://github.com/HeyPuter/puter) as though
they were another harddrive. This works on Linux and Mac OS
using the FUSE interface.
## How to use
[Make sure Go is installed.](https://go.dev/doc/install)
This has been tested on version `go1.22.0`.
Then, run this command to install `puter-fuse`:
```sh
go install github.com/HeyPuter/puter-fuse@v1.0.0
```
## Configuration
### First-time Configuration
The first-time configuration will ask you for your Puter username
and password. If you don't have an account on puter.com you'll need
one in order to use this FUSE driver. Note that once we release the
open-source Puter Kernel you'll be able to login to any instance of
that instead.
Entering your username and password, and accepting the default options
for all other questions, should be sufficient for most installations.
### Configuration file
Configuration is saved to:
- `$HOME/.config/puterfuse/config.json`
## Technical Information
### What's a FUSE?
Filesystem in USErspace (FUSE) is an interface for filesystem
drivers that are loaded as userspace programs rather than in
the kernel. It is available in most POSIX systems like Linux
and Mac OS.
Puter's FUSE driver allows access to a cloud filesystem in a
way that looks like an ordinary local filesystem.
### Performance and Caching
Currently directory trees support read and write-back caching.
The contents of files are not currently cached by default, but
you can set `experimental_cache` to `true` in the configuration
file to enable read and write-back caching for files.