Skip to content
Use etcd as a filesystem
Go Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/etcdfs Add support for unlinking files Mar 17, 2014
.gitignore Initial commit Mar 17, 2014
.travis.yml Still trying to make travis to install dependencies Mar 18, 2014
Makefile Noticed that there was also a change needed in docs May 10, 2017
etcdfs.go Swap command line arguments to follow FUSE standard May 10, 2017


Use etcd as a filesystem


Why using etcd as a fileystem?

Because filesystem API is super stable, widely known and supported, and very simple.

Also because it seems like this can be useful for lots of companies out there that have already deployed apps that read some configuration file from local filesystem and would love to load these configuration files to something like etcd and ensure a consistent view of across a cluster of nodes.

How does it work?

Etcd-fs uses go-fuse and go-etcd, two nice modules to create fuse filesystem in go and use etcd from go.

Every file maps to a key in etcd. Every directory maps to a directory in etcd. The content of every file maps to the value of the key in etcd.

When you mount the filesystem, it will mount the root directory of etcd.

How do I install it?

Clone the project and build it.

make build

This generates an executable file etcdfs. You can mount etcd as a filesystem by running etcdfs ETCD_ENDPOINT MOUNT_PATH. For example:

./etcds /tmp/foobar http://localhost:4001

Then you can access /tmp/foobar and use etcd as a filesystem.

To unmount it:

fusermount -u /tmp/foobar

What is supported?

Basic filesystem operations like:

  • Reading/Writing files
  • Creating/Deleting files
  • Creating/Deleting directories

What is missing?

  • Lots of optimizations
  • Lots of error handling
  • Specifiying more options to etcd connection
  • Mount filesystem to some node in etcd, not necessarily the root
  • Use watch to get updates from etcd and maybe change file modification time (????)
You can’t perform that action at this time.