Installation

How to install and run the Data Product Governance platform.

Prerequisites

Linux server with Docker and Docker Compose installed
Git access to the repository
Tailscale connected (for remote access)

Quick start

# Clone the repository
git clone https://git.writebase.app/thomaslarsson/open-metadata.git
cd open-metadata

# Start all services
docker compose up -d

This starts the full stack:

Service	URL (local)	Purpose
OpenMetadata	http://localhost:8585	Data catalog UI + API
Wiki	http://localhost:3081	This wiki
Airflow	http://localhost:8080	Ingestion pipelines
PostgreSQL	localhost:5432	Metadata database
OpenSearch	localhost:9200	Search index

External access

Once Caddy routing and DNS are configured, the services are available at:

https://data.writebase.app — OpenMetadata catalog
https://wiki.data.writebase.app — Project wiki

Both require Tailscale + Authelia login.

Useful commands

# Check service status
docker compose ps

# View logs for a specific service
docker compose logs -f openmetadata-server
docker compose logs -f wiki-server

# Restart everything
docker compose restart

# Stop everything
docker compose down

# Rebuild wiki after code changes
docker compose up -d --build wiki-server

# Update OpenMetadata to a new version
# Edit the image tag in docker-compose.yml, then:
docker compose pull
docker compose up -d

Architecture

┌─────────────────────────────────┐
│      Caddy (reverse proxy)      │
│  data.writebase.app    → :8585  │
│  wiki.data.writebase.app → :3081│
└──────────┬──────────┬───────────┘
           │          │
    ┌──────▼──────┐  ┌▼────────────┐
    │ OpenMetadata │  │ Wiki server │
    │   :8585     │  │   :3081     │
    │ + Postgres  │  │ Markdown→HTML│
    │ + OpenSearch│  └─────────────┘
    │ + Airflow   │
    └─────────────┘

Troubleshooting

OpenMetadata won't start? It depends on Airflow being healthy first. Check Airflow logs:

docker compose logs openmetadata-airflow

Wiki not reachable externally? Verify the wiki container is on the Caddy network:

docker network connect projekt-startpaket_projekt-net openmetadata-wiki
docker restart caddy

Need to reset everything?

docker compose down -v   # Warning: deletes all data
docker compose up -d