Skip to content
A FUSE filesystem to dynamically build SSH client config
Find file


SSHConfigFS is a FUSE filesystem to build SSH client config files on–the–fly.

If your ~/.ssh/config is anything like mine, then it's pretty long (and only seems to grow). Rather than having to continue managing one big file, I wrote this FUSE filesystem to instead build a config "file" dynamically from many smaller logical chunks.

OS Requirements


Python 2.7 and the osxfuse package (Fuse4X also works, but that project is being merged with osxfuse).




On OSX, first install osxfuse (if you're using Homebrew it's available with brew install osxfuse), then install the python requirements: pip install -r requirements.txt installs only fusepy.

Running the filesystem

To start, run the script. There are no arguments, yet, and it will run in the foreground.

The directory ~/.ssh/config.d/ is monitored for changes to its mtime. Whenever one of the files inside ~/.ssh/config.d/ changes, it triggers re-generation of the combined config.

For a chunk of config to be included in the final output, it must start with a number. In ~/.ssh/config.d/ I keep several files:


These files are combined in the order they appear above, using shell–style globbing, into a single "file" contained within the FUSE mountpoint ~/.sshconfigfs/ (the combined file is called config).

You could create a symbolic link from ~/.ssh/config to the generated ~/.sshconfigfs/config file, so ssh can find it, or use the -F argument to ssh to point it directly at the generated file.

To give another example of use, I have a crontab entry periodically generating ssh Host… config chunks—using data from VPS provider's APIs—which are then written to files inside ~/.ssh/config.d/. This keeps my config up to date without my having to manually manage a large, somewhat dynamic, list of hosts.

Run at startup

I use OSX. To keep SSHConfigFS running, I use the included .plist file to tell OSX's launchd to run the script to mount the filesystem.

mkdir -p ~/Library/LaunchAgents

Edit the com.markhellewell.SSHConfigFS.plist file and change the path to the script. Then:

cp com.markhellewell.SSHConfigFS.plist ~/Library/LaunchAgents/
launchctl load -w ~/Library/LaunchAgents/com.markhellewell.SSHConfigFS.plist

This will keep the SSHConfigFS mounted, as your user, forever.


  • dæmon mode support (at the moment will only run in the foreground)
  • take arguments to configure configd_dir etc.
  • pie shop?


The BSD License. See LICENSE.

Something went wrong with that request. Please try again.