{"id":15692645,"url":"https://github.com/zoni/docker-err","last_synced_at":"2025-05-08T03:06:21.764Z","repository":{"id":35796073,"uuid":"40077448","full_name":"zoni/docker-err","owner":"zoni","description":"Docker containers for Err","archived":false,"fork":false,"pushed_at":"2015-08-05T10:27:55.000Z","size":132,"stargazers_count":7,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-08T03:04:30.750Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/zoni.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-02T11:31:09.000Z","updated_at":"2024-01-03T14:12:36.000Z","dependencies_parsed_at":"2022-09-17T12:23:11.089Z","dependency_job_id":null,"html_url":"https://github.com/zoni/docker-err","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/zoni%2Fdocker-err","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoni%2Fdocker-err/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoni%2Fdocker-err/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoni%2Fdocker-err/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoni","download_url":"https://codeload.github.com/zoni/docker-err/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252989948,"owners_count":21836667,"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":[],"created_at":"2024-10-03T18:36:59.492Z","updated_at":"2025-05-08T03:06:21.709Z","avatar_url":"https://github.com/zoni.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"errbot/err\n==========\n\nDocker images for [Err](http://errbot.net), a chat-bot designed to be easily deployable, extensible and maintainable.\n\n\nAvailable tags\n--------------\n\n* ___python3pypi:___ A Ubuntu 15.04 image with Python 3 and the latest stable release of Err from [PyPI](https://pypi.python.org/pypi/err/).\n* ___python3master:___ A Ubuntu 15.04 image with Python 3 and the latest development snapshot of Err from [GitHub](https://github.com/gbin/err) (master).\n* ___python2pypi:___ A Ubuntu 15.04 image with Python 2 and the latest stable release of Err from [PyPI](https://pypi.python.org/pypi/err/).\n* ___python2master:___ A Ubuntu 15.04 image with Python 2 and the latest development snapshot of Err from [GitHub](https://github.com/gbin/err) (master).\n\n\nUsage\n-----\n\nThis container can be started in three different modes:\n\n* ___shell:___ Start a bash session as the bot account (*err*).\n* ___rootshell:___ Start a bash session as the root account.\n* ___err:___ Start the bot itself. Any additional arguments passed here will be passed on to `err.py`.\n\nFor example, try: `docker run --rm -it errbot/err:python3pypi err --help`\n\nTo successfully run the bot, you will have to mount a [config.py](http://errbot.net/_downloads/config-template.py) into the `/err/` directory (`--volume` option to docker run).\n\nInside the container, `/err/data/` has already been set aside for data storage. You should mount this directory as a data volume as well in order to de-couple your bot data from the container itself.\n\n\nInstalling dependencies\n-----------------------\n\nSome plugins require additional dependencies that may not be installed in the virtualenv by default. There are three ways to deal with this, listed from best practice to worst:\n\n1. Build your own image. Write a `Dockerfile` with `FROM errbot/err:python3pypi` (or one of the other available tags in place of *python3pypi*) and install dependencies as part of the container build process with `RUN runas err /err/virtualenv/bin/pip install somepkg`.\n2. Let Err install dependencies automatically by setting `AUTOINSTALL_DEPS = True` in `setting.py`.\n3. Enter a running container manually (`docker exec --interactive --tty \u003ccontainer-name\u003e /bin/sh -c \"TERM=$TERM exec /bin/bash --login\"` where `\u003ccontainer-name\u003e` is the name listed by `docker ps`) and install with pip as in step 2 above (`runas err /err/virtualenv/bin/pip install somepkg`).\n\n\nContainer layout\n----------------\n\n* `/err`: Home directory of the user account for Err. `config.py` is expected to go here.\n* `/err/.ssh/`: The `.ssh` directory of the bot user (you can mount private SSH keys into this directory if you need to install plugins from private repositories).\n* `/err/virtualenv/`: The virtualenv containing the Python interpreter and installed packages.\n* `/err/data/`: A volume intended to store bot data (`BOT_DATA_DIR` setting of `config.py`).\n\n\nSecurity notes\n--------------\n\n* The bot is run under its own user account (*err*), not as root.\n* SSH is set up to automatically add unknown host keys (*StrictHostKeyChecking no*).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoni%2Fdocker-err","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoni%2Fdocker-err","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoni%2Fdocker-err/lists"}