geerlingguy/fathom repository overview

This project is composed of three main parts:

• Ansible project: This project is maintained on GitHub: geerlingguy/fathom-container⁠. Please file issues, support requests, etc. against this GitHub repository.
• Docker Hub Image: If you just want to use the geerlingguy/fathom Docker image⁠ in your project, you can pull it from Docker Hub.
• Ansible Role: If you need a flexible Ansible role that's compatible with both traditional servers and containerized builds, check out geerlingguy.fathom⁠ on Ansible Galaxy. (This is the Ansible role that does the bulk of the work in managing the Fathom container.)

⁠Versions

Currently maintained versions include:

• 1.x.x, latest: Fathom's latest stable version.

⁠Standalone Usage

If you want to use the geerlingguy/fathom image from Docker Hub, you don't need to install or use this project at all. You can quickly build a Fathom container locally with:

docker run -d --name=fathom -p 9000:9000 geerlingguy/fathom:latest

You can also wrap up that configuration in a Dockerfile and/or a docker-compose.yml file if you want to keep things simple. For example:

version: "3"

services:
  fathom:
    image: geerlingguy/fathom:latest
    container_name: fathom
    ports:
      - "9000:9000"
    restart: always
    # See 'Fathom persistence' for instructions for volumes.
    volumes: []

Then run:

docker-compose up -d

Now you should be able to access the Fathom interface at http://localhost:9000/.

⁠Fathom persistence

If you would like to preserve the Fathom database and configuration, mount a volume like -v ./fathom:/opt/fathom:rw,delegated.

Or, if using a Docker Compose file:

services:
  fathom:
    ...
    volumes:
      - ./fathom:/opt/fathom:rw,delegated

⁠License

MIT / BSD

⁠Author Information

This container build was created in 2019 by Jeff Geerling⁠, author of Ansible for DevOps⁠.