{"id":21896887,"url":"https://github.com/fititnt/uwazi-docker","last_synced_at":"2025-07-29T03:35:56.410Z","repository":{"id":141349264,"uuid":"128586634","full_name":"fititnt/uwazi-docker","owner":"fititnt","description":"Dockerized version of Uwazi (“openness\" in Swahili). HURIDOCS designed Uwazi to make human rights information more open and accessible to the defenders who need it.","archived":false,"fork":false,"pushed_at":"2023-07-30T23:02:47.000Z","size":107,"stargazers_count":11,"open_issues_count":4,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-28T23:11:21.842Z","etag":null,"topics":["docker","uwazi","uwazi-docker"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fititnt.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}},"created_at":"2018-04-08T02:02:48.000Z","updated_at":"2023-12-14T21:51:23.000Z","dependencies_parsed_at":null,"dependency_job_id":"ccca508e-c3fa-4902-a909-66b03de703c7","html_url":"https://github.com/fititnt/uwazi-docker","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fititnt%2Fuwazi-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fititnt%2Fuwazi-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fititnt%2Fuwazi-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fititnt%2Fuwazi-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fititnt","download_url":"https://codeload.github.com/fititnt/uwazi-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249125173,"owners_count":21216700,"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","uwazi","uwazi-docker"],"created_at":"2024-11-28T14:14:47.032Z","updated_at":"2025-04-15T17:49:00.952Z","avatar_url":"https://github.com/fititnt.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Uwazi with Docker\nThis work-in-progress repository allows you to run the\n[Uwazi](http://www.uwazi.io) using [Docker containers](https://docker.com). It\ncan be a good alternative if you are testing the software and have no\nproficiency with the entire stack of applications involved.\n\n**The Uwazi software is available in the [github.com/huridocs/uwazi](https://github.com/huridocs/uwazi/)\nrepository.**\n\n## What is Uwazi?\n\n\u003e In Swahili, Uwazi means “openness.” HURIDOCS designed Uwazi to make human rights\ninformation more open and accessible to the defenders who need it.\n[Uwazi](http://www.uwazi.io) is a web-based platform that goes beyond just\nstoring and tagging documents. Users work directly with the text inside these\notherwise uneditable documents to add new layers of information.\n[Uwazi is a web-based, open-source solution](https://github.com/huridocs/uwazi/)\nfor building and sharing document collections.\n\nSee also [History of Uwazi](https://github.com/huridocs/uwazi/wiki/History-of-Uwazi).\n\n## Usage\nThe uwazi-docker requires docker compose installed. See\n[requirements](requirements.md). If you are a developer, can also check some\nadvanced information on [development-instructions.md](development-instructions.md)\nand a draft of [production-instructions.md](production-instructions.md).\n\n### Install\nRun these commands on your terminal **only** the first time:\n\n```bash\ngit clone https://github.com/fititnt/uwazi-docker.git\ncd uwazi-docker\ndocker compose run -e IS_FIRST_RUN=true --rm uwazi # Install without sample data\n# docker compose run -e IS_FIRST_DEMO_RUN=true --rm uwazi # Install with sample data\n```\n\nWith very fast internet and disks, this step will take between 8 to 15 minutes.\nThe `IS_FIRST_DEMO_RUN=true` is an alternative that starts with test/example data.\n\n\u003cdetails\u003e\n\u003csummary\u003e(Advanced) All initialization options with default values\u003c/summary\u003e\n\nUwazi docker fetch data from git, and a very specific release (UWAZI_GIT_RELEASE_REF defaults to tag production, but this likely eventually will require upgrade uwazi-docker itself) and initialize with empty database (DB_INITIALIZATION_PATH, but you may want to change for a example test database, or even upstream might change path in the future).\n\nWith this in mind, the default values might need updates (which in this case please open an issue and report the problem) but in the meantime you can just change the options.\n\n\u003cpre\u003e\ngit clone https://github.com/fititnt/uwazi-docker.git\ncd uwazi-docker\ndocker compose run -e IS_FIRST_RUN=true -e UWAZI_GIT_RELEASE_REF=production -e DB_INITIALIZATION_PATH=/home/node/uwazi/database/blank_state/uwazi_development --rm uwazi\n\u003c/pre\u003e\n\u003c/details\u003e\n\n### Run\n\n```bash\n# Run uwazi on background (automatic restart on reboot unless stopped)\ndocker compose up -d uwazi\n```\n\nOpen your browser at \u003chttp://localhost:3000/\u003e. Initial user: `admin`, password: `change this password now`.\n(or if using `IS_FIRST_DEMO_RUN=true`, user: `admin`, password: `admin`).\n\n#### `yarn migrate` and `yarn reindex`\n\nAt installation step the `yarn migrate` and `yarn reindex` are always executed,\nhowever the database will be erased to a blank state.\nHowever, if for some you already have real data and not major database upgrade,\nin which MongoDB and ElasticSearch might need some minor custom steps outside of Uwazi control,\nthis command will run once only the `yarn migrate` and `yarn reindex`.\n\n```bash\ndocker compose run -e RUN_YARN_MIGRATE_REINDEX=true --rm uwazi\n```\n\nJust to be sure, if working with real data, **please backup the volumes first**.\n\n### Basic docker commands\n\n```bash\n# Stop all containers from this uwazi-docker and do not restart again until you explicit ask for it\ndocker compose stop\n\n# Using \"-d\" param to run uwazi and its dependencies on background\ndocker compose up -d uwazi\n\n# No \"-d\" param, start uwazi, MongoDB \u0026 Elastic Search and see what is happening inside the containers\ndocker compose up uwazi\n\n# See what containers are running now\ndocker ps\n\n# See all docker volumes\ndocker volume ls\n\n# See docker volumes that stores data from uwazi-docker (hint: these ones to backup \u0026 restore)\ndocker volume ls | grep 'mongodb_data1\\|uploaded_documents'\n\n# Want some GUI to see what is happening on MongoDB? Use nosqlclient\ndocker compose up -d mongo-gui-mongoclient\n\n# Want some GUI to see what is happening on Elastic Search? Try Dejavu\ndocker compose up -d elasticsearch-gui-dejavu\n```\n\n### Extra features\n\n#### Want some GUI to see what is happening on MongoDB? Use nosqlclient\n\n```bash\ndocker compose up -d mongo-gui-mongoclient\n```\n\nBy default, uses \u003chttp://localhost:51000/\u003e.\n\n#### Want some GUI to see what is happening on Elastic Search? Try Dejavu\n\n```bash\ndocker compose up -d elasticsearch-gui-dejavu\n```\n\nBy default, uses \u003chttp://localhost:52000/\u003e.\n\n### Uninstall\n\nSee [how to uninstall](uninstall.md).\n\n## License\n\n[![Public Domain](https://i.creativecommons.org/p/zero/1.0/88x31.png)](UNLICENSE)\n\nTo the extent possible under law, [Emerson Rocha](https://github.com/fititnt)\nhas waived all copyright and related or neighboring rights to this work to\n[Public Domain](UNLICENSE).\n\nOptionally, you can choose to use the [MIT License](https://opensource.org/licenses/MIT)\ninstead of Public Domain unlicense.\n\n\u003c!--\n\ndocker compose --file docker compose.yml run -e IS_FIRST_RUN=true --rm uwazi\n# (...)\ndocker stop $(docker ps -a -q)\ndocker system prune --all\ndocker volume prune\n\n# debug containers\ndocker ps\ndocker logs --tail 50 --follow --timestamps uwazi-docker-mongo-1\ndocker logs --tail 50 --follow --timestamps uwazi-docker-elasticsearch-1\n\n\n###\ngit clone -b production --single-branch --depth=1 https://github.com/huridocs/uwazi.git huridocs-uwazi-docker/\n\n--\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffititnt%2Fuwazi-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffititnt%2Fuwazi-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffititnt%2Fuwazi-docker/lists"}