Remote Filesystem (SSH)

Use remote filesystem through SSH as the repository backend.

• Use the original ~/.ssh/config without pain
• Support password authentication
• Support public key authentication
• Support SSH agent
• Support SSH proxy by ProxyCommand or ProxyJump
• Support host key checking through ~/.ssh/known_hosts
• Concurrent uploading and downloading

To use SSH backend, you have to configure ~/.ssh/config.

1. Configure the ~/.ssh/config

   Host myserver
       HostName myserver.hosts
       User myname
       IdentityFile ~/.ssh/id_ed25519
   

2. Check if you can access the SSH server successfully

   ssh myserver
   

For more information, please see ssh config manual

Init a workspace

avc init myserver:path/to/mydataset

Clone a repository

avc clone myserver:path/to/mydataset
cd mydataset/

There are two ways to connect to the destination server through bastion (proxy) server.

1. Configure ~/.ssh/config

   host bastion
       hostname mybastion.hosts
       user myname
       identityfile ~/id_ed25519
   
   host myserver
       hostname myserver.hosts
       user myname
       identityfile ~/id_ed25519
       ProxyCommand ssh bastion -W %h:%p
   

2. Init the workspace

   avc init myserver:path/to/mydataset
   

1. Configure ~/.ssh/config

   host bastion
       hostname mybastion.hosts
       user myname
       identityfile ~/id_ed25519
   
   host myserver
       hostname myserver.hosts
       user myname
       identityfile ~/id_ed25519
       ProxyJump bastion
   

2. Init the workspace

   avc init myserver:path/to/mydataset
   

• Port
• User
• IdentityFile
• StrictHostKeyChecking
• ProxyCommand
• ProxyJump