Home

Madlabs Developers Portal

Welcome to the Madlabs Developer Portal. This site is the central resource for developers collaborating on the infrastructure, tools, and services of the Madlabs ecosystem. It documents the decisions, deployments, and tools that make up the operational backbone of Madlabs.

What is Madlabs?

Madlabs is an open, modular platform for building digital applications, AI agents, and scientific tools with social, civic, or academic impact. It is maintained by Hadox Research Labs and integrated into broader initiatives involving universities, nonprofits, and international collaboration.

What's documented here

  • How to set up a local development environment (Ubuntu WSL + Docker)
  • How CI/CD works through Gitea, Drone, and GitHub
  • How our documentation portal is deployed to docs.hadox.org
  • How Netdata is configured and secured for server monitoring
  • Rationale for adopting and dropping different CMS tools
  • NGINX setup, custom domains, and Let's Encrypt SSL setup
  • How to contribute as a developer and use this portal

Technologies used

  • MkDocs with Material theme
  • Docker and Docker Compose
  • NGINX + Certbot (Let's Encrypt)
  • Drone CI
  • Gitea (self-hosted Git)
  • Netdata (server metrics and health)
  • GitHub (mirroring)

Contribute

If you’re contributing to Madlabs, start here. This portal will grow as we document more of our tooling and workflows. Pull requests are welcome via git.hadox.org.