{"id":15693650,"url":"https://github.com/joschi/docker-prosody-alpine","last_synced_at":"2025-03-11T18:31:11.953Z","repository":{"id":29740981,"uuid":"122653106","full_name":"joschi/docker-prosody-alpine","owner":"joschi","description":"Prosody Docker image based on Alpine Linux","archived":false,"fork":false,"pushed_at":"2025-03-05T20:16:34.000Z","size":120,"stargazers_count":7,"open_issues_count":2,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-05T21:43:20.267Z","etag":null,"topics":["docker","docker-image","jabber","prosody","xmpp","xmpp-server"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/joschi/prosody-alpine/","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joschi.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2018-02-23T17:39:29.000Z","updated_at":"2025-03-05T20:16:37.000Z","dependencies_parsed_at":"2023-01-14T15:34:14.947Z","dependency_job_id":"28fa02a4-ab12-435a-9a6c-0c148212bdde","html_url":"https://github.com/joschi/docker-prosody-alpine","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joschi%2Fdocker-prosody-alpine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joschi%2Fdocker-prosody-alpine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joschi%2Fdocker-prosody-alpine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joschi%2Fdocker-prosody-alpine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joschi","download_url":"https://codeload.github.com/joschi/docker-prosody-alpine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243090244,"owners_count":20234753,"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":["docker","docker-image","jabber","prosody","xmpp","xmpp-server"],"created_at":"2024-10-03T18:46:59.678Z","updated_at":"2025-03-11T18:31:11.666Z","avatar_url":"https://github.com/joschi.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prosody\n\n[![Docker Stars](https://img.shields.io/docker/stars/joschi/prosody-alpine.svg)][hub]\n[![Docker Pulls](https://img.shields.io/docker/pulls/joschi/prosody-alpine.svg)][hub]\n[![Docker Image Version](https://img.shields.io/docker/v/joschi/prosody-alpine)](hub)\n\n[hub]: https://hub.docker.com/r/joschi/prosody-alpine/\n\n## What is Prosody?\n\nProsody is a modern XMPP communication server. It aims to be easy to set up and configure, and efficient with system resources.\n\nAdditionally, for developers it aims to be easy to extend and give a flexible system on which to rapidly develop added functionality, or prototype new protocols.\n\n### Example\n\n```\n# docker run -d \\\n    --name prosody\n    -p 5222:5222 \\\n    -p 5269:5269 \\\n    -e LOCAL=romeo \\\n    -e DOMAIN=shakespeare.lit \\\n    -e PASSWORD=juliet4ever \\\n    -v /data/prosody/vhosts:/etc/prosody/conf.d \\\n    -v /data/prosody/modules:/usr/local/lib/prosody/modules \\\n    joschi/prosody-alpine:0.10.0-1\n```\n\n## Configuration\n\nThe default [Prosody configuration file](prosody.cfg.lua) can be overwritten entirely (`/etc/prosody/prosody.cfg.lua`) or extended by adding configuration snippets into the `/etc/prosody/conf.d/` directory.\n\n### Virtual hosts\n\nNew domains can be added by placing configuration snippets with the virtual host definitions to `/etc/prosody/conf.d/`.i\n\nMinimal example:\n\n```\n# cat vhosts/example-org.cfg.lua\nVirtualHost \"example.org\"\n    enable = true\n# docker run -d \\\n    --name prosody\n    -p 5222:5222 \\\n    -p 5269:5269 \\\n    -v /data/prosody/vhosts:/etc/prosody/conf.d \\\n    joschi/prosody-alpine:0.10.0-1\n```\n\n### Creating a user\n\nThis Docker image supports creating a single user on startup by providing the following environment variables:\n\n* `LOCAL`: local part of the JID\n* `DOMAIN`: domain part of the JID\n* `PASSWORD`: plaintext password of the user\n\nFor example, the environment variables `LOCAL=foobar`, `DOMAIN=example.com`, `PASSWORD=supersecret` would create a user named \"foobar@example.com\" with the password \"supersecret\".\n\nOther than that, users can be created using [`prosodyctl`](https://prosody.im/doc/prosodyctl) in a running container:\n\n```\n# docker exec -it prosody prosodyctl register foobar example.com supersecret\n```\n\n\n## Prosody modules\n\nAdditional modules, e. g. from the [Prosody Community Modules](https://modules.prosody.im/), can be added by putting the Lua files into the `/usr/local/lib/prosody/modules/` directory.\n\n\n## Persistent data\n\nProsody only writes data into two locations, which have to be persisted in Docker volumes to survive a container restart:\n\n* `/var/lib/prosody/`: The Prosody [`data_path`](https://prosody.im/doc/configure#general_server_settings)\n* `/var/run/prosody/prosody.pid`: The Prosody [`pidfile`](https://prosody.im/doc/configure#posix-only_options).\n\n\n## Acknowledgements\n\nThis Docker image is partly based on the official [prosody/prosody](https://github.com/prosody/prosody-docker) Docker image.\n\n\n## License\n\nThis Docker image is licensed under the MIT license, see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoschi%2Fdocker-prosody-alpine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoschi%2Fdocker-prosody-alpine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoschi%2Fdocker-prosody-alpine/lists"}