Skip to content

ucphhpc/docker-volume-sshfs

This branch is 100 commits ahead of, 11 commits behind vieux/docker-volume-sshfs:master.

Folders and files

NameName
Last commit message
Last commit date
Mar 14, 2023
Dec 30, 2024
Jan 25, 2023
Jun 17, 2024
Dec 30, 2024
Dec 30, 2024
Oct 14, 2018
Dec 19, 2017
Dec 30, 2024
Jan 25, 2023
Sep 15, 2021
Dec 30, 2024
Dec 30, 2024
Dec 30, 2024
Dec 30, 2024
Dec 30, 2024

Repository files navigation

Docker volume plugin for sshFS

See vieux/sshfs for original documentation

This plugin allows you to mount remote folder using sshfs in your container easily.

Usage

Using a password

1 - Install the plugin

$ docker plugin install ucphhpc/sshfs

# or to enable debug 
docker plugin install ucphhpc/sshfs DEBUG=1

# or to change where plugin state is stored
docker plugin install ucphhpc/sshfs state.source=<any_folder>

2 - Create a volume

Make sure the source path on the ssh server was exists.

Or you'll be failed while use/mount the volume.

$ docker volume create -d ucphhpc/sshfs -o sshcmd=<user@host:path> -o password=<password> [-o port=<port>] [-o <any_sshfs_-o_option> ] sshvolume
sshvolume
$ docker volume ls
DRIVER              VOLUME NAME
local               2d75de358a70ba469ac968ee852efd4234b9118b7722ee26a1c5a90dcaea6751
local               842a765a9bb11e234642c933b3dfc702dee32b73e0cf7305239436a145b89017
local               9d72c664cbd20512d4e3d5bb9b39ed11e4a632c386447461d48ed84731e44034
local               be9632386a2d396d438c9707e261f86fd9f5e72a7319417901d84041c8f14a4d
local               e1496dfe4fa27b39121e4383d1b16a0a7510f0de89f05b336aab3c0deb4dda0e
ucphhpc/sshfs         sshvolume

3 - Use the volume

$ docker run -it -v sshvolume:<path> busybox ls <path>

Using an ssh key

1 - Install the plugin

$ docker plugin install ucphhpc/sshfs sshkey.source=/home/<user>/.ssh/

# or to enable debug 
docker plugin install ucphhpc/sshfs DEBUG=1 sshkey.source=/home/<user>/.ssh/

# or to change where plugin state is stored
docker plugin install ucphhpc/sshfs state.source=<any_folder> sshkey.source=/home/<user>/.ssh/

2 - Create a volume

Make sure the source path on the ssh server exists.

Or you will fail when you use/mount the volume.

$ docker volume create -d ucphhpc/sshfs -o sshcmd=<user@host:path> [-o IdentityFile=/root/.ssh/<key>] [-o port=<port>] [-o <any_sshfs_-o_option> ] sshvolume
sshvolume
$ docker volume ls
DRIVER              VOLUME NAME
local               2d75de358a70ba469ac968ee852efd4234b9118b7722ee26a1c5a90dcaea6751
local               842a765a9bb11e234642c933b3dfc702dee32b73e0cf7305239436a145b89017
local               9d72c664cbd20512d4e3d5bb9b39ed11e4a632c386447461d48ed84731e44034
local               be9632386a2d396d438c9707e261f86fd9f5e72a7319417901d84041c8f14a4d
local               e1496dfe4fa27b39121e4383d1b16a0a7510f0de89f05b336aab3c0deb4dda0e
ucphhpc/sshfs         sshvolume

3 - Use the volume

$ docker run -it -v sshvolume:<path> busybox ls <path>

LICENSE

MIT

About

sshfs docker volume plugin

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 56.1%
  • Shell 33.1%
  • Makefile 7.4%
  • Dockerfile 3.4%