:tools upload

Map local to remote projects via ssh/ftp

1. Description

Uses ssh-deploy to map a local folder to a remote one.

From the ssh-deploy README:

The ssh-deploy plug-in for Emacs makes it possible to effortlessly deploy local files and directories to remote hosts via Tramp (including but not limited to SSH, SFTP, FTP). It tries to provide functions that can be easily used by custom scripts.

The idea for this plug-in was to mimic the behavior of PhpStorm deployment functionality.

1.1. Maintainers

This module has no dedicated maintainers. Become a maintainer?

1.2. Module flags

This module has no flags.

1.4. Hacks

No hacks documented for this module.

2. Prerequisites

This module has no external prerequisites.

3. Usage

Uses ssh-deploy to map a local folder to a remote one. Set ssh-deploy-root-remote and ssh-deploy-root-local in a .dir-locals.el file to establish this mapping.


((nil . ((ssh-deploy-root-local . "/local/path/to/project")
	 (ssh-deploy-root-remote . "/ssh:user@server:/remote/project/")
	 (ssh-deploy-on-explicit-save . t))))

ssh-deploy-root-local is optional, and will resort to doom-project-root if unspecified.

4. TODO Configuration

This module’s configuration documentation is incomplete. Complete it?

Check out Deployment configuration examples for some ideas of what’s possible.

5. Troubleshooting

5.1. root-local and root-remote must match

The final directory names much match

((nil . ((ssh-deploy-root-local . "/local/path/to/example-project")
	 (ssh-deploy-root-remote . "/ssh:user@server:/remote/example-project/")

6. TODO Appendix

This module has no appendix yet. Write one?