Skip to content
This repository has been archived by the owner on Dec 5, 2021. It is now read-only.

David-Lor/Dockerized-Python-SSH

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Dockerized Python+SSH image πŸπŸ”πŸ³

Objective

This container provides the base Python container with a SSH server preinstalled that can be used to connect to the Python interpreter and upload files remotely, i.e. using PyCharm.

How does it work?

By default, a non-root user, created on the Dockerfile, is used for normal operations. Is recommended to connect SSH using this non-root user, using the username pythonssh and the password sshpass by default.

How to deploy?

docker run -d -p 2222:22 --name pythonssh davidlor/python-ssh
  • Change -p 2222:22 if you want to change the exposed port on the host machine (2222 to other prefered port)
  • Change the --name "pythonssh" if you want

Connecting with root

If required, root user can be connected through SSH. However, you must set root password manually, following these steps:

  • Enable root login on SSH (from within the container):
    • Deploy a Docker container using this image as usual
    • Run bash on it as root: docker exec -it -u root pythonssh bash (replace pythonssh with the container name or ID)
    • Once you are inside the container, run: echo "PermitRootLogin yes" >> /etc/ssh/sshd_config
    • Restart SSH service running service ssh restart
  • Set a password for root:
    • Once you are inside the container, run passwd and you will be asked for a new password for the user root
    • Run exit when done to quit the container
  • Now you can login with root through SSH

Mountpoints

Mountpoints are defined on Dockerfile, so volumes will be automatically created if you do not define them.

  • You can mount the .ssh directory for the non-root user, to manage the valid SSH keys used to connect through SSH.
    • Location: /home/pythonssh/.ssh (being pythonssh the username of the non-root account)
  • You can mount the /etc/ssh directory for keeping the ssh config files on a persistent volume
    • Location: /etc/ssh

Usage

Notice that the latest Python executable is located at /usr/local/bin/python. You must input this route i.e. in PyCharm.

Usage instructions for PyCharm

How to build?

You can build your own image using this repository. This can be useful for changing the username/password or building for other platforms.

git clone https://github.com/Pythoneiro/Dockerized-Python-SSH.git
docker build -t "local/python-ssh" --build-arg USERNAME=pythonssh --build-arg USERPASS=sshpass Dockerized-Python-SSH
  • change local/python-ssh by your custom desired image name
  • change pythonssh by your custom desired username
  • change sshpass by your custom desired user password

TODO

  • Customize user/password by ENV variables or "secret file"
  • Set SSH log level for getting an output on /var/log/auth.log
  • Install sudo

About

Docker image with Python + SSH server πŸπŸ”πŸ³

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published