{"id":16060845,"url":"https://github.com/geerlingguy/fathom-container","last_synced_at":"2025-03-18T05:30:28.859Z","repository":{"id":54222501,"uuid":"168790573","full_name":"geerlingguy/fathom-container","owner":"geerlingguy","description":"Fathom container for website analytics, built with Ansible.","archived":false,"fork":false,"pushed_at":"2025-02-02T22:24:08.000Z","size":11,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-28T07:12:13.657Z","etag":null,"topics":["analytics","ansible","ansible-container","container","docker","fathom","website"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/geerlingguy/fathom/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geerlingguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"geerlingguy","patreon":"geerlingguy"}},"created_at":"2019-02-02T03:35:34.000Z","updated_at":"2025-02-02T22:24:11.000Z","dependencies_parsed_at":"2024-10-27T17:20:50.138Z","dependency_job_id":"b42abbb8-3ba0-4f32-ba6b-1c6e5de392a0","html_url":"https://github.com/geerlingguy/fathom-container","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Ffathom-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Ffathom-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Ffathom-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Ffathom-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geerlingguy","download_url":"https://codeload.github.com/geerlingguy/fathom-container/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243902293,"owners_count":20366260,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analytics","ansible","ansible-container","container","docker","fathom","website"],"created_at":"2024-10-09T04:06:45.776Z","updated_at":"2025-03-18T05:30:28.843Z","avatar_url":"https://github.com/geerlingguy.png","language":null,"funding_links":["https://github.com/sponsors/geerlingguy","https://patreon.com/geerlingguy"],"categories":[],"sub_categories":[],"readme":"# Fathom Container (Built with Ansible)\n\n[![Build](https://github.com/geerlingguy/fathom-container/actions/workflows/build.yml/badge.svg)](https://github.com/geerlingguy/fathom-container/actions/workflows/build.yml) [![Docker pulls](https://img.shields.io/docker/pulls/geerlingguy/fathom)](https://hub.docker.com/r/geerlingguy/fathom/)\n\nThis project is composed of three main parts:\n\n  - **Ansible project**: This project is maintained on GitHub: [geerlingguy/fathom-container](https://github.com/geerlingguy/fathom-container). Please file issues, support requests, etc. against this GitHub repository.\n  - **Docker Hub Image**: If you just want to use [the `geerlingguy/fathom` Docker image](https://hub.docker.com/r/geerlingguy/fathom/) in your project, you can pull it from Docker Hub.\n  - **Ansible Role**: If you need a flexible Ansible role that's compatible with both traditional servers and containerized builds, check out [`geerlingguy.fathom`](https://galaxy.ansible.com/geerlingguy/fathom/) on Ansible Galaxy. (This is the Ansible role that does the bulk of the work in managing the Fathom container.)\n\n## Versions\n\nCurrently maintained versions include:\n\n  - `1.x.x`, `latest`: Fathom's latest stable version.\n\n## Standalone Usage\n\nIf 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:\n\n    docker run -d --name=fathom -p 9000:9000 geerlingguy/fathom:latest\n\nYou 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:\n\n    version: \"3\"\n    \n    services:\n      fathom:\n        image: geerlingguy/fathom:latest\n        container_name: fathom\n        ports:\n          - \"9000:9000\"\n        restart: always\n        # See 'Fathom persistence' for instructions for volumes.\n        volumes: []\n\nThen run:\n\n    docker-compose up -d\n\nNow you should be able to access the Fathom interface at `http://localhost:9000/`.\n\n### Fathom persistence\n\nIf you would like to preserve the Fathom database and configuration, mount a volume like `-v ./fathom:/opt/fathom:rw,delegated`.\n\nOr, if using a Docker Compose file:\n\n    services:\n      fathom:\n        ...\n        volumes:\n          - ./fathom:/opt/fathom:rw,delegated\n\n## Management with Ansible\n\n### Prerequisites\n\nBefore using this project to build and maintain Fathom images for Docker, you need to have the following installed:\n\n  - [Docker Community Edition](https://docs.docker.com/engine/installation/) (for Mac, Windows, or Linux)\n  - [Ansible](http://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html)\n\n### Build the image\n\nFirst, install Ansible role requirements:\n\n    ansible-galaxy install -r requirements.yml\n\nThen, make sure Docker is running, and run the playbook to build the container:\n\n    ansible-playbook main.yml\n\nOnce the image is built, you can run `docker images` to see the `fathom` image that was generated.\n\n\u003e Note: If you get an error like `Failed to import docker`, run `pip install docker`.\n\n### Push the image to Docker Hub\n\nSee the GitHub Actions workflow file in this repository for how it pushes all the tagged images automatically on any commit to the `master` branch.\n\n## License\n\nMIT / BSD\n\n## Author Information\n\nThis container build was created in 2019 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Ffathom-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeerlingguy%2Ffathom-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Ffathom-container/lists"}