Files
sshfs_connect/README.md
T
nevaforget 8edddc5a28
Update PKGBUILD version / update-pkgver (push) Successful in 5s
feat: add -l (list) and -u (unmount) flags
A second sshfsc <alias> call only printed "Already mounted"; tearing
down a mount required ls + fusermount by hand. -l lists active mounts
verified via mountinfo.Mounted, -u <Host> unmounts and removes the
empty mountpoint dir. Flags are mutually exclusive.
2026-05-04 09:25:55 +02:00

60 lines
1.5 KiB
Markdown

Quickly mount remote systems via SSHFS based on your ssh_config
Mounts land under `$XDG_RUNTIME_DIR/sshfs/<Host>` (typically `/run/user/$UID/sshfs/<Host>`), using the ssh_config alias as label, not the resolved IP. The directory is auto-cleaned on logout (tmpfs).
# Install
## Arch Linux (Moonarch repo)
Available in the Moonarch package repository as `sshfsc-git`:
```
paru -S sshfsc-git
```
## From source
```
go build -o sshfsc
install -Dm755 sshfsc /usr/local/bin/sshfsc
```
# Dependencies
- [SSHFS](https://wiki.archlinux.org/title/SSHFS)
- [Go](https://wiki.archlinux.org/title/Go) >= 1.25 (build-time)
# Usage
```
sshfsc <Host> # mount
sshfsc -u <Host> # unmount
sshfsc -l # list active mounts
```
## Arguments
| Flag | Description |
| ---- | ----------- |
| `-e` | open mountpoint in your editor |
| `-v` | verbose: print resolved ssh_config fields (HostName, User, Port, IdentityFile) |
| `-r`, `--remote-dir <path>` | remote directory to mount (default: remote home) |
| `-l` | list active mounts under `$XDG_RUNTIME_DIR/sshfs/` and exit |
| `-u` | unmount the given `<Host>` and exit (mutually exclusive with `-l`) |
By default only the resolved mount path is printed. Use `-v` for the full
ssh_config dump.
Editor Sublime-Text (`subl`) is currently hardcoded. [See](https://gitea.moonarch.de/nevaforget/sshfs_connect/issues/1)
# Example ssh config
See https://wiki.archlinux.org/title/OpenSSH#Configuration
```
Host myserver
HostName 127.0.0.1
User sshusername
IdentityFile ~/.ssh/id_rsa
```