Skip to main content

A utility to manage all socats of yours

Project description


socatlord is a tool to manage multiple socats

You feed it with a config file placed at /etc/socatlord that has the syntax like:

# this is a comment ->
80 ->
udp ->

TCP is the default protocol. Socatlord will spawn as many socats as necessary.


After you put this file, call socatlord install. This will install and enable socatlord to start during your startups (only if you're using Systemd). /etc/socatlord will be created about then, if it does not already exists. If you haven't done so, now it would be a good time to fill it up.

Note that installation itself will not start socatlord! After installation put your configuration in /etc/socatlord.

Later call either socatlord run or systemctl start socatlord.service to terminate currently running socats and launch your own. This may terminate your SSH connection, if you're using a socat to proxy it though, however it will destroy them and restart in one go.

You can also call socatlord stop to stop all socats.

You can provide an optional argument of -v to see what commands are launched. You can provide an optional explicit path to config file, if /etc/socatlord is meant not to be used. socatlord must be run as root. A check will be made for this.



  • socatlord will check if socats are alive after started


  • socatlord uses argparse
  • socatlord will check if it's ran as root


  • socat's will be silenced if the mode is not verbose
  • better default /etc/socatlord


First formal release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

socatlord-1.3.tar.gz (6.0 kB view hashes)

Uploaded Source

Built Distributions

socatlord-1.3-py3.8.egg (5.4 kB view hashes)

Uploaded Source

socatlord-1.3-py2.py3-none-any.whl (6.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page