This is a quick start guide to get a test server up and running in less than 5 minutes with docker-compose.
This setup will let any password authenticate. Only use it for testing.
Step 1: Set up a Dockerized environment¶
Step 2: download the sample files¶
Please download the contents of the example directory from the source code repository.
Step 3: Launch ContainerSSH¶
In the downloaded directory run
docker-compose build and then
Step 4: Logging in¶
ssh foo@localhost -p 2222 on the same machine. You should be able to log in with any password.
Alternatively you can also try the user
busybox to land in a Busybox container.
Step 5: Making it productive¶
The authentication and configuration server included in the example is a dummy server and lets any password in. To actually use ContainerSSH you will have to write your own authentication server and you may want to write your own configuration server too. We recommend reading the architecture overview before proceeding.
You can pass the
CONTAINERSSH_ALLOW_ALL environment variable to the demo auth-config server to build a honeypot.