explaingit

jessfraz/dockerfiles

13,934DockerfileAudience · ops devopsComplexity · 2/5Setup · moderate

TLDR

A personal collection of Dockerfiles that package many desktop and server tools as Docker images, all published on Docker Hub so anyone can pull and run them instantly.

Mindmap

mindmap
  root((jessfraz dockerfiles))
    What it does
      Package tools as containers
      Desktop and server apps
      Published on Docker Hub
    Distribution
      Docker Hub jess account
      Signed at r.j3ss.co
      Pull and run instantly
    Contributing
      Add run command comment
      Submit pull request
      shellcheck tests
    Makefile Commands
      build all images
      run single image
      latest-versions check
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Pull a pre-built Docker image of any tool from this collection and run it without installing it locally.

USE CASE 2

Use shell aliases from the companion dotfiles repo to launch Docker containers as if they were normal local commands.

USE CASE 3

Copy an existing Dockerfile as a starting template for packaging your own tool in a container.

USE CASE 4

Pull notary-signed images from r.j3ss.co when you need cryptographically verified copies.

Tech stack

DockerShellMakefile

Getting it running

Difficulty · moderate Time to first run · 5min

Requires Docker installed, GUI apps may need extra Linux display server configuration to render a window on screen.

In plain English

This repository is a personal collection of Dockerfiles kept by the developer Jessie Frazelle. A Dockerfile is a small recipe that describes how to package a program along with everything it needs to run, so it can start the same way on any machine. The repo gathers many of these recipes in one place, covering tools the author uses on her own desktop and on servers. The README explains that almost all of these packaged images are published on Docker Hub under the account named jess, where anyone can download them. It also notes a side detail: because a signing feature called notary does not work with Docker Hub's automatic builds, the author additionally rebuilds the same images on her own private registry at r.j3ss.co so the public can still pull signed copies from there. The README points to a companion repository, the author's dotfiles, which holds personal configuration files. In particular it links to a file of shortcuts (aliases) that let you launch each of these Docker images with a short command instead of typing the full instruction every time. This is offered as a convenience for people who want to actually run the tools. There is a short section on contributing. The author says she tries to put a comment at the top of each Dockerfile showing the exact command used to run that image. If you find a file that is missing this command, she invites you to send in a fix, which on GitHub is called a pull request. The final part lists the commands available through the project's Makefile, a helper that automates routine jobs. Running make help prints the menu: build compiles all the Dockerfiles, image builds a single chosen one, run launches a chosen image using the command stored at the top of its file, latest-versions checks whether the contents are up to date, and shellcheck and test run quality checks on the scripts. The README is brief and does not describe each individual image in detail, so the repo is best understood as a working toolbox rather than a guided tutorial.

Copy-paste prompts

Prompt 1
Using jessfraz/dockerfiles and its companion dotfiles, set up shell aliases so I can launch containerized desktop apps like Firefox with a single short command.
Prompt 2
Show me how to build and run the Firefox Docker image from jessfraz/dockerfiles on my Linux desktop with X11 display forwarding.
Prompt 3
How do I add a missing run command comment to a Dockerfile in jessfraz/dockerfiles and submit a pull request with the fix?
Prompt 4
Walk me through using the Makefile in jessfraz/dockerfiles to build all images and check whether their contents are up to date.
Open on GitHub → Explain another repo

← jessfraz on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.