{"id":16237811,"url":"https://github.com/marcus67/docker-little-brother","last_synced_at":"2026-04-11T00:04:13.774Z","repository":{"id":98035526,"uuid":"296737684","full_name":"marcus67/docker-little-brother","owner":"marcus67","description":null,"archived":false,"fork":false,"pushed_at":"2021-01-09T18:18:34.000Z","size":35,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-14T05:43:34.185Z","etag":null,"topics":["debian","docker","docker-compose","parental-control","python3"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marcus67.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-09-18T21:58:22.000Z","updated_at":"2023-11-01T05:39:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"599f844c-dad2-4dcf-97bd-81f2d65bb67d","html_url":"https://github.com/marcus67/docker-little-brother","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcus67%2Fdocker-little-brother","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcus67%2Fdocker-little-brother/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcus67%2Fdocker-little-brother/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marcus67%2Fdocker-little-brother/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marcus67","download_url":"https://codeload.github.com/marcus67/docker-little-brother/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247808959,"owners_count":20999804,"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":["debian","docker","docker-compose","parental-control","python3"],"created_at":"2024-10-10T13:37:15.472Z","updated_at":"2025-12-30T22:38:20.592Z","avatar_url":"https://github.com/marcus67.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![LittleBrother-Logo](doc/icon-baby-panda-128x128.png)\n![LittleBrother-Logo](doc/docker-logo-128x128.png)\n\n# Docker Support for `LittleBrother`\n\n## Overview\n\nThere is a [docker image](https://hub.docker.com/repository/docker/marcusrickert/little-brother-slave) \navailable to run a LittleBrother slave process. The easiest way to use it start as follows:\n \n*   Download the [docker-compose.yml](docker/docker-compose.yml) file from GitHub and store in a local directory.\n    Alternatively, clone this repository by issuing \n    \n        git clone https://github.com/marcus67/docker-little-brother.git    \n\n*   Copy the [template.env](docker/template.env) and save it as `.env` into the same directory.\n\n*   Read the following short sections to choose the right version of the image and acknowledge the security aspects.\n\n*   Continue with Section *Running the Slave*.\n\n## Tag Naming Conventions\n\nThe tag names of the images are derived from the pattern `BRANCH-REVISION` where `BRANCH` is either `master` or\n`release` and `REVISION` represents the number as listed in [changes](CHANGES.md). The special tag `latest` is used\nfor the most up-to-date release revision.\n\n## Security Details\n\n*   In order for LittleBrother to be able to kill processes, the configuration contains the option `pid: host`. \nThis makes sure that the container sees ALL processes including those running *outside* the container.\n\n*   For the same reason the container has to be run in a privileged mode (using `privileged:true`). Ideally,\nthis should be replaced by activating a set of Linux capabilities. \nFor details see [this issue](https://github.com/marcus67/docker-little-brother/issues/1).\n\n*   In order to be able to \"speak\" (that is play sound files), the process inside the container has to access the sound\ndevice of the host. This is made possible by mounting the file `/etc/asound.conf` and the device `/dev/snd` \ninto the container. **Note:** This requirement is obsolete since notifications should be issued by \n[LittleBrotherTaskbar](https://github.com/marcus67/little_brother_taskbar) now and no longer by the slave process.\n\n\n\n## Running the Container\n\n### Running the Regular Slave\n\n*   Edit the environment variables in the `.env` file. See the comments in the file.\n*   Open a shell in the directory containing `docker-compose.yml`.\n*   Start the container by issuing in the shell\n\n        docker-compose up -d slave \n\n### Running the Legacy Slave\n\nThe legacy slave can be used to enable notifications and audio playback using the application. However,\nthis is not recommended. Please, consider installing \n[LittleBrotherTaskbar](https://github.com/marcus67/little_brother_taskbar) instead.\n\nThe steps are the same as with the regular slave (see above) except for issuing\n\n        docker-compose up -d legacy-slave \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcus67%2Fdocker-little-brother","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarcus67%2Fdocker-little-brother","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarcus67%2Fdocker-little-brother/lists"}