selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Uwazi logo

Self-host Uwazi

1.229.276

Open-source document management for human rights

ReleaseOpen SourceMIT
Updated9 hours ago
LanguageTypescript
Setup difficultyAdvanced
Stars
328
CPU
2 CPU cores
RAM
4 GB RAM
Storage
20 GB disk space
Port
3000 (HTTP web application)
Requires
Elasticsearch, MinIO (S3 storage), MongoDB, Mongosh, Node.js, pdftotext (Poppler), PostgreSQL, Redis, Yarn
Install with Docker Compose
Records management interface showing document collectionsCustom template builder with property definitionsPDF metadata extraction service interfaceMulti-language translation interfaceData visualization with map viewRoles and permissions management

What is Uwazi?

Uwazi is a flexible, web-based database application developed by HURIDOCS for capturing, organizing, analyzing, and sharing collections of documents and information. Originally built for human rights documentation, it serves NGOs, journalists, researchers, archivists, and educators who need to manage structured document collections. Key capabilities include custom templates and properties for data modeling, full-text and PDF search with faceted filters, PDF metadata extraction via ML models, automatic translation across 180+ languages, map and card visualizations, role-based access control at the record level, public entity pages for publishing, CSV import/export, and a RESTful API. The platform integrates with the Tella mobile app for offline data collection in risky environments. Self-hosting is free under the MIT license, requiring Node.js 20, ElasticSearch 8.18, MongoDB 7.0 (as a replica set), Redis, PostgreSQL, and MinIO/S3 storage, with Docker Compose provided for infrastructure dependencies. The application runs on port 3000 by default. Managed hosting tiers are available for organizations preferring a hosted solution.

Should you self-host Uwazi?

Uwazi scores 54/100 on selfhost.directory (how scoring works) and ranks #25 of 46 in Document Management. It has 328 GitHub stars.

It shipped 6 stable releases in the past year. The latest, 1.229.276, came out on 27 October 2026. New versions land roughly every 1 days.

Setup is advanced: plan for several services and some ongoing maintenance. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Reactive Resume (87/100, 44 983 stars). It scores higher overall, so compare the two before you pick. See Uwazi vs Reactive Resume side by side.

Features

  • Automatic translations
  • CSV import and export
  • Custom templates and properties
  • Data visualization (cards, table, map)
  • Full-text and PDF search
  • ML-powered metadata extraction
  • Multi-language support (180+ languages)
  • Named Entity Recognition
  • PDF segmentation
  • Public entity pages
  • Public submission forms
  • RESTful API
  • Role-based Access Control
  • Thesauri and controlled vocabularies
  • Two-factor authentication

Uwazi README

How to install Uwazi

Install Uwazi with Docker Compose

./run start

Runs ElasticSearch, MongoDB, Redis, PostgreSQL, and MinIO via Docker Compose. ElasticSearch container claims 2GB memory; Docker Engine needs at least 3GB allocated.

How to configure Uwazi

  • AI_ASSISTANT_SERVICE_URLhttp://localhost:5051AI assistant service URL

    AI assistant service URL

  • CLUSTER_MODEfalseEnable cluster mode

    Enable cluster mode

    values: true, false

  • DATABASE_NAMEuwazi_developmentMongoDB database name

    MongoDB database name

  • DBHOST127.0.0.1MongoDB host

    MongoDB host

  • DEFAULT_SENDER_EMAILDefault sender email for notifications

    Default sender email for notifications

  • DEFAULT_SITE_NAMEDefault site name

    Default site name

  • ELASTICSEARCH_URLhttp://localhost:9200ElasticSearch URL

    ElasticSearch URL

  • EXTERNAL_SERVICEStrueEnable external ML services

    Enable external ML services

    values: true, false

  • FEATURE_FLAG_AI_ASSISTANTtrueEnable AI assistant feature

    Enable AI assistant feature

    values: true, false

  • FEATURE_FLAG_PARAGRAPH_EXTRACTIONfalseEnable paragraph extraction feature

    Enable paragraph extraction feature

    values: true, false

  • FEATURE_FLAG_POSTGRES_COREfalseEnable PostgreSQL core (experimental)

    Enable PostgreSQL core (experimental)

    values: true, false

  • FEATURE_FLAG_THEME_CUSTOMIZATIONfalseEnable theme customization

    Enable theme customization

    values: true, false

  • FEATURE_FLAG_TRANSLATION_SERVICEfalseEnable translation service feature

    Enable translation service feature

    values: true, false

  • FILES_ROOT_PATHRoot path for file storage

    Root path for file storage

  • INDEX_NAMEuwazi_developmentElasticSearch index name

    ElasticSearch index name

  • MONGO_URIFull MongoDB connection string

    Full MongoDB connection string

  • MULTI_TENANTfalseEnable multi-tenant mode

    Enable multi-tenant mode

    values: true, false

  • NEW_HEADERfalseEnable new header UI

    Enable new header UI

    values: true, false

  • NODE_ENVdevelopmentNode environment

    Node environment

    values: development, production

  • PARAGRAPH_EXTRACTION_URLhttp://localhost:5056Paragraph extraction service URL

    Paragraph extraction service URL

  • PORT3000Server port

    Server port

  • POSTGRES_DBuwazi_developmentPostgreSQL database name

    PostgreSQL database name

  • POSTGRES_HOST127.0.0.1PostgreSQL host

    PostgreSQL host

  • POSTGRES_PASSWORDuwaziPostgreSQL password

    PostgreSQL password

  • POSTGRES_PORT5432PostgreSQL port

    PostgreSQL port

  • POSTGRES_USERuwaziPostgreSQL user

    PostgreSQL user

  • REDIS_HOSTlocalhostRedis host

    Redis host

  • REDIS_PORT6379Redis port

    Redis port

  • S3_ACCESS_KEY_IDminioadminS3 access key

    S3 access key

  • S3_BUCKETuwazi-developmentS3 bucket name

    S3 bucket name

  • S3_ENDPOINThttp://127.0.0.1:9000S3/MinIO endpoint

    S3/MinIO endpoint

  • S3_SECRET_ACCESS_KEYminioadminS3 secret key

    S3 secret key

  • SESSIONS_BACKENDmongoSession storage backend

    Session storage backend

    values: mongo, postgres

  • TRANSLATION_SERVICE_URLTranslation service URL

    Translation service URL

  • USE_ELASTIC_ICUfalseEnable ICU Analysis Plugin for ElasticSearch

    Enable ICU Analysis Plugin for ElasticSearch

    values: true, false

  • USER_SESSION_SECRETSession secret for authentication

    Session secret for authentication

Uwazi releases & version history

FAQ

Does Uwazi support my languages?

Uwazi can be localized into more than 180 languages, including both widely spoken and less common languages.

Where can I see Uwazi's source code?

The source code is available on GitHub at github.com/huridocs/uwazi.

Where can I find instructions on how to set up and use Uwazi?

Setup and usage instructions are available on the Uwazi Docs platform.

Are there videos available to learn more about Uwazi?

Yes, there are videos on the HURIDOCS YouTube channel and the Uwazi Docs platform has how-to guides.

Can I try a demo of Uwazi?

Yes, you can book a demo session with the Uwazi team to see the tool in action.

More in Data Visualization

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…