{"id":26062053,"url":"https://github.com/opendatateam/docker-udata","last_synced_at":"2025-04-11T10:58:17.336Z","repository":{"id":37752112,"uuid":"75865085","full_name":"opendatateam/docker-udata","owner":"opendatateam","description":"udata and plugins all-in-one Docker image","archived":false,"fork":false,"pushed_at":"2024-12-03T09:00:15.000Z","size":193,"stargazers_count":15,"open_issues_count":19,"forks_count":13,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-25T07:22:22.202Z","etag":null,"topics":["docker-image","elasticsearch","redis","standalone","theme","udata","udata-configuration","uwsgi"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/udata/udata/builds","language":"Dockerfile","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/opendatateam.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":"2016-12-07T18:43:53.000Z","updated_at":"2024-08-01T16:08:40.000Z","dependencies_parsed_at":"2025-03-08T21:15:14.885Z","dependency_job_id":null,"html_url":"https://github.com/opendatateam/docker-udata","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/opendatateam%2Fdocker-udata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opendatateam%2Fdocker-udata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opendatateam%2Fdocker-udata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opendatateam%2Fdocker-udata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opendatateam","download_url":"https://codeload.github.com/opendatateam/docker-udata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248381674,"owners_count":21094524,"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","elasticsearch","redis","standalone","theme","udata","udata-configuration","uwsgi"],"created_at":"2025-03-08T15:49:23.839Z","updated_at":"2025-04-11T10:58:17.317Z","avatar_url":"https://github.com/opendatateam.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# udata all-in-one Docker image\n\n[![](https://images.microbadger.com/badges/image/udata/udata:2-alpine.svg)](https://microbadger.com/images/udata/udata:2-alpine \"Docker image details\")\n\n## Quick start\n\n```bash\ncd docker-udata\ndocker-compose up\n```\n\nTo be able to upload files, you will need to access the docker instance through an URL with a tld, i.e. `localhost.local` for example (set it in your `/etc/hosts` on your Unix machine).\n\nCheck that [`localhost.local:7000`](http://localhost.local:7000) is available in a browser.\n\n\n## Details\n\nThis Docker image provide udata as well as known plugins and gouvfr theme.\n\nIt is packaged to run within uwsgi with gevent support.\n\nBy default, it exposes the frontend on the port **7000** and expect the following services:\n\n* **MongoDB** on `mongodb:27017`\n* **Elasticsearch** on `elasticsearch:9200`\n* **Redis** on `redis:6379`\n\nand use the following paths:\n\n* `/udata/udata.cfg` for udata configuration\n* `/udata/fs` for storage root (as a volume by default)\n* `/udata/public` for public assets root\n* `/udata/uwsgi/*.ini` for uwsgi configuration files\n* `/src/*/setup.py` for extra development packages to install\n\nYou can customize configuration by providing a custom `udata.cfg` or custom uwsgi `ini` file.\n\nA [sample docker-compose.yml file](https://github.com/opendatateam/docker-udata/blob/master/docker-compose.yml)\nis also available in the repository.\n\n## Running docker image service\n\nFetch the latest Docker image version\n\n```bash\ndocker pull udata/udata\n```\n\nThen you can run the container with different configurations:\n\n* a custom udata configuration mounted (here a local `udata.cfg`):\n\n    ```bash\n    docker run -v /absolute/path/to/udata.cfg:/udata/udata.cfg udata/udata\n    ```\n\n* with custom uwsgi configurations (here contained in the `uwsgi` directory):\n\n    ```bash\n    docker run -v `$PWD`/uwsgi:/udata/uwsgi udata/udata\n    ```\n\n* with file storage as local volume binding:\n\n    ```bash\n    docker run -v /path/to/storage:/udata/fs udata/udata\n    ```\n\n# Running standalone instance\n\nYou can run standalone (front/worker/beat) instance with the `front`, `worker` and `beat` commands:\n\n```bash\ndocker run udata/udata front\ndocker run udata/udata worker\ndocker run udata/udata beat\n```\n\n## Running udata commands\n\nYou can also execute `udata` commands with:\n\n```bash\ndocker run [DOCKER OPTIONS] udata/udata [UDATA COMMAND]\n```\n\nBy example, to initialise the database with fixtures and initialize the search index:\n\n```bash\ndocker run -it --rm udata/udata init\n```\n\nList all commands with:\n\n```bash\ndocker run -it --rm udata/udata --help\n```\n\n**Note:** Some commands requires either MongoDB, Redis or Elasticsearch to be up and ready.\n\n## Running celery commands\n\nYou are also able to run `celery` commands with:\n\n```bash\ndocker run -it --rm udata/udata celery status\n```\n\n## Running bash\n\nFor debugging purpose you can acces a bash prompt with:\n\n```bash\ndocker run [DOCKER OPTIONS] udata/udata bash\n```\n\n## Installing extra sources\n\n:warning: This section is here as an example of what you could do but is not the recommended way to develop on custom sources. See [getting started](https://udata.readthedocs.io/en/stable/getting-started/) to start a development environment.\n\nSee the `sample/theme` directory to see a full theme development using `docker-compose`.\n\nYou can install extra sources by mounting directories as subdirectories of `/src/`.\n\nGiven you have a udata theme `awesome-theme` in `my-theme` directory\nand you want to use docker to hack on it with live reload,\nyou need to have the following lines in your `udata.cfg`:\n\n```python\nPLUGINS = ['my-theme']\nTHEME = 'awesome-theme'\n```\n\nThen you can run the udata Development server with:\n\n```bash\ndocker run -it -v `$PWD`/my-theme:/src/my-theme -v `$PWD`/udata.cfg:/udata/udata.cfg --rm udata/udata serve\n```\nYour theme will be installed and activated.\n\n# Examples\n\nYou can see some docker-compose configuration examples in the `sample` directory of this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopendatateam%2Fdocker-udata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopendatateam%2Fdocker-udata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopendatateam%2Fdocker-udata/lists"}