Installation

To install this module, you need to:

1. install paramiko. You need version 2.0 or higher
2. install the module. It will generate a new host key during installation

Configuration

To configure this module, you need to:

1. be sure there's a proper hostkey in config parameter document_sftp.hostkey
2. add some authorized key on the users' form who should be allowed to login via SFTP

Usage

To use this module, you need to:

1. add some keys to your user's authorized key field
2. say sftp -p 2222 $yourodoohost and browse through the possibilities
3. when you found what you want, say sshfs -p 2222 "admin@localhost:By model/res.company/1" $yourmountpoint to see all attachments of your main company in $yourmountpoint
4. pay someone to implement locking (see below) in order to be able to write on this

Known issues / Roadmap

• implement writing. This is not trivial, because we need some concept of locking, UI for that and take care of some corner cases
• allow to restrict actions on SFTP that are allowed normally (because rf -rf $yourmountpoint/ can become a serious problem)
• should support directories
• implement some other useful virtual roots (Mails, By Directory, By name, ...) This should look like symlinks to the rigid designator (model+id) from the point of view of the user.
• with this, auth_ssh should be simple to implement enabling passwordless logins for your scripts
• if you want to see error messages from the SFTP server thread, use --log-handler=paramiko:DEBUG

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.

Credits

Maintainer

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit https://odoo-community.org.