Endlessh Ansible Role

WIP Roles waiting for changes in endlessh-go. DO NOT USE
endlessh-go is a golang implementation of endlessh, a ssh trapit

• with everything run in Docker containers
• powered by endlessh-go container image

Installing

To configure and install endlessh on your own server(s), you should use a playbook like Mother of all self-hosting or write your own.

Configuration

To enable this service, add the following configuration to your vars.yml file and re-run the installation process:

########################################################################
#                                                                      #
# endlessh                                                                 #
#                                                                      #
########################################################################

endlessh_enabled: true

########################################################################
#                                                                      #
# /endlessh                                                                #
#                                                                      #
########################################################################

You can overwrite the default config variable using endlessh_config variable.
Here is an exemple to use ssh port 22 on host and 2222 on container

endlessh_config:
  sshPorts: 
  - [22, 2222]

See the full list of options in the default/main.yml file

Exposing the web interface

By setting a hostname you will expose endlessh on this domain. Usually you should also set up basic_auth in this case, otherwise everyone will be able to access your metrics

endlessh_hostname: endlessh.example.org

# Uncomment following lines to add basic auth
#endlessh_container_labels_metrics_middleware_basic_auth_enabled: true
#endlessh_container_labels_metrics_middleware_basic_auth_users : '<user>:<hashed_password>'