{"id":13494316,"url":"https://github.com/prosody/prosody-docker","last_synced_at":"2025-03-28T13:33:10.123Z","repository":{"id":23223221,"uuid":"26580516","full_name":"prosody/prosody-docker","owner":"prosody","description":"Docker image building system for the Prosody XMPP server","archived":false,"fork":false,"pushed_at":"2025-02-13T18:15:59.000Z","size":48,"stargazers_count":149,"open_issues_count":13,"forks_count":48,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-02-13T19:25:50.215Z","etag":null,"topics":["docker-image","xmpp-server"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/prosody/prosody/","language":"Lua","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/prosody.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-11-13T09:29:23.000Z","updated_at":"2025-02-13T18:16:03.000Z","dependencies_parsed_at":"2025-02-14T14:02:29.219Z","dependency_job_id":null,"html_url":"https://github.com/prosody/prosody-docker","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prosody%2Fprosody-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prosody%2Fprosody-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prosody%2Fprosody-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prosody%2Fprosody-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prosody","download_url":"https://codeload.github.com/prosody/prosody-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246037655,"owners_count":20713448,"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-image","xmpp-server"],"created_at":"2024-07-31T19:01:23.857Z","updated_at":"2025-03-28T13:33:10.115Z","avatar_url":"https://github.com/prosody.png","language":"Lua","funding_links":[],"categories":["Lua"],"sub_categories":[],"readme":"# Docker build scripts for Prosody build server\n\nThis is the Prosody Docker image building repository. It is used by our build server to build and publish Docker images for stable releases and nightly builds.\n\nThere are many alternative Dockerfiles for Prosody available if this one\ndoes not suit your needs:\n\n  - [OpusVL/prosody-docker](https://github.com/OpusVL/prosody-docker/)\n  - [unclev/prosody-docker-extended](https://github.com/unclev/prosody-docker-extended)\n\n## Published images\n\nFor images please see here: [Prosody on Docker](https://hub.docker.com/r/prosody/prosody/).\n\n## Running\n\nIt works by enabling the [prosody package repository](https://prosody.im/download/package_repository) and installing the selected Prosody package from there based on the `PROSODY_PACKAGE` build argument.\n\nDocker images are built off an __Debian 12 (bookworm)__ base.\n\n```bash\ndocker run -d --name prosody -p 5222:5222 prosody/prosody\n```\n\nA user can be created by using environment variables `LOCAL`, `DOMAIN`, and `PASSWORD`. This performs the following action on startup:\n\n  prosodyctl register *local* *domain* *password*\n\nAny error from this script is ignored. Prosody will not check the user exists before running the command (i.e. existing users will be overwritten). It is expected that [mod_admin_adhoc](http://prosody.im/doc/modules/mod_admin_adhoc) will then be in place for managing users (and the server).\n\n### Ports\n\nThe image exposes the following ports to the docker host:\n\n* __80__: HTTP port\n* __443__: HTTPS port\n* __5222__: c2s port\n* __5269__: s2s port\n* __5347__: XMPP component port\n* __5280__: BOSH / websocket port\n* __5281__: Secure BOSH / websocket port\n\nNote: These default ports can be changed in your configuration file. Therefore if you change these ports will not be exposed.\n\n### Volumes\n\nVolumes can be mounted at the following locations for adding in files:\n\n* __/etc/prosody__:\n  * Prosody configuration file(s)\n* __/etc/prosody/certs__:\n  * SSL certificates\n* __/etc/prosody/modules__:\n  * Location for including additional modules\n\n### Environment Variables\n\n* `DOMAIN`, `LOCAL`, `PASSWORD` - These three are used by `entrypoint.sh` to create an initial account `$LOCAL@$DOMAIN` with `$PASSWORD` as password.\n* `PROSODY_PLUGIN_PATHS` - Comma-separated list of additional paths to search for plugins. Defaults to `/etc/prosody/modules`.\n* `PROSODY_ADMINS` - Comma-separated list of user addresses treated as admins.\n* `PROSODY_ENABLE_MODULES` - Comma-separated list of additional plugins to load.\n* `PROSODY_DISABLE_MODULES` - Comma-separated list of modules to disable, e.g. for auto-enabled modules.\n* `PROSODY_TURN_HOST` - Hostname of TURN server\n* `PROSODY_TURN_PORT` - Port number of TURN server\n* `PROSODY_TURN_SECRET` - Shared secret for TURN\n* `PROSODY_TURN_TLS_PORT` -  Port number for STUN over TLS\n* `PROSODY_RETENTION_DAYS` - How many days worth of message archives and shared file to keep.\n* `PROSODY_S2S_SECURE_AUTH` - Whether to require that remote servers present valid certificates. Enabled by default.\n* `PROSODY_C2S_RATE_LIMIT` - Rate limit for client-to-server connections. Defaults to `10kb/s`.\n* `PROSODY_S2S_RATE_LIMIT` - Rate limit for server-to-server connections. Defaults to `30kb/s`.\n* `PROSODY_STORAGE` - [Storage driver](https://prosody.im/doc/storage) to use. Defaults to `internal`.\n* `PROSODY_SQL_DRIVER` - One of `SQLite3`, `PostgreSQL` or `MySQL`. Selects SQL backend when `PROSODY_STORAGE` is set to `sql`.\n* `PROSODY_SQL_DB` - Name of SQL database to use.\n* `PROSODY_SQL_HOST` - Hostname of SQL database to connect to (PostgreSQL and MySQL only).\n* `PROSODY_SQL_USERNAME`, `PROSODY_SQL_PASSWORD` - Credentials for connecting to SQL database.\n* `PROSODY_ARCHIVE_EXPIRY_DAYS` - When set, overrides `PROSODY_RETENTION_DAYS` for message archives.\n* `PROSODY_LOGLEVEL` - Log level, one of `debug`, `info`, `warn`, `error`. Defaults to `info`.\n* `PROSODY_STATISTICS` - [Statistics provider](https://prosody.im/doc/statistics) to use, e.g. `internal`. Default disabled.\n* `PROSODY_STATISTICS_INTERVAL` - Statistics collection interval. A number or the string `manual` for OpenMetrics-triggered collection. Defaults to `60`.\n* `PROSODY_CERTIFICATES` - Path to TLS certificates and private keys, relative to the config file. Defaults to `certs`, i.e.\n* `PROSODY_VIRTUAL_HOSTS` - Comma-separated list of domain names to initialize as hosts that provide user accounts. Defaults to the hostname of the container. `/etc/prosody/certs`.\n* `PROSODY_NETWORK_HOSTNAME` - Public domain name for use with e.g. HTTP. Defaults to the first entry in `PROSODY_VIRTUAL_HOSTS`.\n* `PROSODY_COMPONENTS` - Comma-separated list of _internal_ components in the form `name.example.com:type` where `type` can be e.g. `muc`, `http_file_share`.\n* `PROSODY_MUC_MODULES` - Comma-separated list of additional modules to enable on a MUC component.\n* `PROSODY_UPLOAD_EXPIRY_DAYS` - When set, overrides `PROSODY_RETENTION_DAYS` for uploaded files.\n* `PROSODY_UPLOAD_LIMIT_MB` - Size limit in MiB for individual uploaded files.\n* `PROSODY_UPLOAD_STORAGE_GB` - Total amount of storage available for file uploads.\n* `PROSODY_EXTERNAL_COMPONENTS` - Comma-separated list of _external_ components, in the form of `name.example.com:secret`.\n* `PROSODY_COMPONENT_SECRET` - Component shared secret if not provided as part of `PROSODY_EXTERNAL_COMPONENTS`.\n* `PROSODY_EXTRA_CONFIG` - Path to additional configuration file. Can contain wildcards. Defaults to `/etc/prosody/conf.d/*.cfg.lua`.\n\n\n### Example\n\n```bash\ndocker run -it \\\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/configuration:/etc/prosody \\\n   -v /logs/prosody:/var/log/prosody \\\n   -v /data/prosody/modules:/usr/lib/prosody-modules \\\n   prosody/prosody:0.12\n```\n\n## Building\n\n```bash\ndocker build --build-arg PROSODY_PACKAGE=prosody-0.12 -t prosody/prosody:0.12 .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprosody%2Fprosody-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprosody%2Fprosody-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprosody%2Fprosody-docker/lists"}