---
name: "sshproxyd"
section: "8"
platform: "linux"
package: "sshproxy"
version: "0.6.0~beta2-2"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/sshproxyd"
---

# sshproxyd(8)

sshproxy daemon

## NAME

sshproxyd - sshproxy daemon

## SYNOPSIS

**sshproxyd \[--config-dir *cfgdir*\]**\
       Normal run (in the foreground).

**sshproxyd \[--config-dir *cfgdir*\] --daemon \[--user *user*\]** \[--pid *pidfile*\]\
       Run daemonized (in the background).

## DESCRIPTION

*sshproxyd* acts as an authenticating proxy gateway for SSH2 connections. It does not use [*ssh*(1)](/ssh/1.md) nor [*sshd*(8)](/sshd/8.md) but implements its own SSH2 stack with the **paramiko** library.

## OPTIONS

- **--config-dir (-c)**

  Specify a configuration directory where *sshproxyd* will find the main configuration file [*sshproxy.ini*(5)](/sshproxy.ini/5.md) and the private DSA private key *id\_dsa*. Default value is *~/.sshproxy*.

- **--daemon (-d)**

  Run *sshproxyd* in daemon mode. In daemon mode, *sshproxyd* puts itself in the background and runs forever, waiting for incomming connections.

- **--user (-u)**

  Run *sshproxyd* as *user*. This option is mandatory if *sshproxyd* is run as root.

- **--pid (-p)**

  Record the process id of the daemon in the file *pidfile*. Default is  */var/run/sshproxyd.pid*.

## FILES

*~/.sshproxy/sshproxy.ini*

The main configuration file. See *sshproxy.ini* for further details.

*~/.sshproxy/id\_dsa*

The private hostkey file. This hostkey is automatically generated by *sshproxyd* at startup if it doesn't exist.

*/var/run/sshproxyd.pid*

The pid file, mostly useful when *sshproxyd* is run with the **-d** option.

## ENVIRONMENT

- SSHPROXY\_CONFIG

  If non-null the full path to the configuration directory. Equivalent to the **-c** option.

## DIAGNOSTICS

Two debug logs are generated when *sshproxyd* is running:

\~/.sshproxy/log/paramiko.log

This file contains paramiko's debug messages, relative to the SSH2 protocol.

\~/.sshproxy/log/sshproxy.log

This file contains sshproxy's debug messages, relative to authentication, ACLs and proxying.

## BUGS

Not all features of [*sshd*(8)](/sshd/8.md) are implemented yet. *sshproxyd* currently provides the following features:

Remote shell

Remote command execution

X11 forwarding

scp file transfer

remote port forwarding

local port forwarding

You can report any bug found on the sshproxy mailing list:

sshproxy@penguin.fr

## AUTHOR

David Guerizec \<david@guerizec.net\>

## SEE ALSO

**sshproxy-setup**(1), **pssh**(1), [**pscp**(1)](/pscp/1.md), [**sshproxy.ini**(5)](/sshproxy.ini/5.md),

The paramiko home page: \<*http://www.lag.net/paramiko/*\>

The sshproxy home page: \<*http://sshproxy-project.org/*\>

The sshproxy online documentation:

\<*http://sshproxy-project.org/documentation/*\>
