{"id":20915976,"url":"https://github.com/indico/indico-containers","last_synced_at":"2025-05-13T10:33:52.862Z","repository":{"id":46757824,"uuid":"121395564","full_name":"indico/indico-containers","owner":"indico","description":"Containerization of Indico","archived":false,"fork":false,"pushed_at":"2024-10-30T10:34:55.000Z","size":158,"stargazers_count":27,"open_issues_count":10,"forks_count":26,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-10-30T11:31:04.745Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/indico.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":"2018-02-13T14:56:50.000Z","updated_at":"2024-10-30T10:35:25.000Z","dependencies_parsed_at":"2024-09-13T22:05:39.013Z","dependency_job_id":null,"html_url":"https://github.com/indico/indico-containers","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indico%2Findico-containers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indico%2Findico-containers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indico%2Findico-containers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indico%2Findico-containers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/indico","download_url":"https://codeload.github.com/indico/indico-containers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225206887,"owners_count":17438200,"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-11-18T16:19:12.008Z","updated_at":"2025-05-13T10:33:52.847Z","avatar_url":"https://github.com/indico.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker containers for Indico\n\n![Pipeline Status](https://github.com/indico/indico-containers/actions/workflows/ci.yml/badge.svg)\n\n## Production-like setup\n\n\u003e [!IMPORTANT]\n\u003e The Docker configuration described here is provided *as is* and might require\n\u003e further modifications depending on your system. Note that, we do not use this\n\u003e setup ourselves so it is not as battle-tested as one of our official\n\u003e [installation guides](https://docs.getindico.io/en/stable/installation/). We\n\u003e are happy to provide guidance if needed, but a good working knowledge of\n\u003e Docker is recommended.\n\n### Quickstart\n\nBefore starting the containers, set a `SECRET_KEY` in the [`indico-prod/indico.conf`](indico-prod/indico.conf) file. You can generate one by running the following snippet from the terminal:\n\n```sh\npython -c 'import os; print(repr(os.urandom(32)))'\n```\n\nOnce this is done, start the containers with:\n\n```sh\n$ cd indico-prod \u0026\u0026 docker compose up\n```\n\nIndico will be accessible at [localhost:8080](localhost:8080). You can also access the wsgi app directly at [localhost:9090](localhost:9090) which skips the nginx proxy. If you do this, make sure to update `BASE_URL` in the [`indico-prod/indico.conf`](indico-prod/indico.conf) file.\n\n### Configuration\n\nThere are a couple config files which you can use to configure this setup.\n- [indico-prod/.env](indico-prod/.env) - This file specifies general settings like the DB config, nginx port and the path to `indico.conf`.\n- [indico-prod/indico.conf](indico-prod/indico.conf) - This is a sample Indico config file. It is passed to the containers as a read-only volume. Feel free to modify it based on your needs. You can use a different config file by changing the `INDICO_CONFIG` variable in [indico-prod/.env](indico-prod/.env).\n- [indico-prod/logging.yaml](indico-prod/logging.yaml) - The default logging config for Indico. Feel free to modify it or use a different config by changing the `INDICO_LOGGING_CONFIG` variable.\n\nThe production setup contains the following containers:\n- _indico-web_ - Indico running behind uwsgi (accessible at [localhost:9090](localhost:9090))\n- _indico-celery_ - Indico celery task runner\n- _indico-celery-beat_ - celery beat\n- _indico-redis_ - redis\n- _indico-nginx_ - nginx proxy (by default accessible at [localhost:8080](localhost:8080), can be changed by updating `NGINX_PORT`)\n\n_indico-web_ uses the `getindico/indico` image that we publish to Dockerhub. You can build this image locally using the [build_latest.sh](build_latest.sh) script. The image pulls the latest Indico release from PyPI together with the `indico-plugins` package. You can use the `indico.conf` file to specify which plugins you want to enable.\n\n### Different setups\n\nIf you don't need the DB and the nginx proxy, you can just run:\n```sh\n$ docker compose up indico-web\n```\n\nThis will bring up only Indico, celery and redis. The DB should be on the same network to be accessible.\n\nThe `getindico/indico` image can also be used completely standalone outside of this docker-compose setup, as long as the remaining services (postgres, redis, celery) are available elsewhere. In that case, make sure to update `REDIS_CACHE_URL`, `CELERY_BROKER` in your `indico.conf` and the DB connection settings in [prod.env](prod.env).\n\nThis is how you can run Indico on its own:\n```sh\n$ docker run \\\n    --mount type=bind,src=/path/to/indico.conf,target=/opt/indico/etc/indico.conf \\\n    getindico/indico /opt/indico/run_indico.sh\n```\n\nOr to run celery from the same image:\n```sh\n$ docker run \\\n    --mount type=bind,src=/path/to/indico.conf,target=/opt/indico/etc/indico.conf \\\n    getindico/indico /opt/indico/run_celery.sh\n```\n\nIn the above, we omit the network setup to make e.g. the DB accessible from the containers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findico%2Findico-containers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Findico%2Findico-containers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findico%2Findico-containers/lists"}