dsfinc/jumpbox repository overview

⁠dsfinc/jumpbox⁠

Started from this monsoft⁠ image, will try to maintain this image for myself, but am happy to share it out as well.

⁠Contents

• Introduction⁠
  • Installation⁠
  • Quickstart⁠
  • Authorized Keys⁠

⁠Introduction

Simple ssh jumpbox, just ensure you have your "authorized-keys" file and "/home" volumes set, you should be all set.

⁠Installation

Automated builds of the image are available on Dockerhub⁠ and is the recommended method of installation.

⁠Keys

Each user is authenticated by ssh key during login, and to be able to do it, specially 'crafted' file is required. It's like normal authorized_keys file but with username at the beginning. General file format is:

username:ssh_public_key

⁠Quickstart

Docker Run:

docker run --name jumpbox -d --restart=always \
  -p serverip:9922:22 \
  -v /path/to/authorized_keys:/etc/authorized_keys:ro -v /path/to/home:/home \
  -e TZ="America/Chicago" -e USERS="user1 user2 user3" \
  dsfinc/jumpbox

OR

Docker Compose

version: "3.8"
services:
    jumpbox:
        container_name: jumpbox
        hostname: jumpbox
        image: dsfinc/jumpbox
        restart: unless-stopped
        ports:
            - "9922:22"
        volumes:
            - /path/to/authorized_keys:/etc/authorized_keys:ro
            - /path/to/home:/home
        environment:
            - TZ=America/Chicago
            - USERS=user1 user2 user3

⁠- Parameters

Container images are configured using parameters passed at runtime (such as those above).