📚 Memory Protocol Files

# System Architecture - Obsidian Hybrid Stack

**Created:** 2026-02-12
**Last Updated:** 2026-02-12
**Status:** ✅ Production

---

## 🏗️ Infrastructure Overview

This is a self-hosted Obsidian hybrid stack designed for cross-device note synchronization and web-based access.

### Technology Stack

| Component | Technology | Purpose |
|-----------|-----------|---------|
| **Sync Backend** | CouchDB 3 | Real-time synchronization across devices |
| **Web Interface** | LinuxServer Obsidian | Browser-based vault access (REMOVED) |
| **Reverse Proxy** | Nginx + Let's Encrypt | HTTPS termination and routing |
| **Orchestration** | Docker Compose | Service management |

---

## 🔌 Service Endpoints

| Service | Internal Port | External Port | Public URL |
|---------|--------------|---------------|------------|
| **CouchDB Sync** | 5984 | 8092 | https://couchdb.nocturnefox.com |

---

## 🔐 Authentication

### CouchDB Admin Credentials
- **Username:** `obsidian_admin`
- **Password:** `ANTIquity9!0*`
- **Admin Panel:** https://couchdb.nocturnefox.com/_utils

### Security Notes
- All traffic encrypted via HTTPS (Let's Encrypt)
- CORS enabled for mobile app connections
- Max upload size: 100MB (configured in Nginx)

---

## 📁 Data Persistence

### Docker Volumes
```
obsidian-stack_couchdb-data     → /opt/couchdb/data
obsidian-stack_couchdb-config   → /opt/couchdb/etc/local.d
```

### Vault Location
- **Host Path:** `/var/lib/docker/volumes/obsidian-stack_obsidian-vaults/_data`
- **This File:** `00_Meta/DevLogs/System_Architecture.md`

---

## 🚀 Deployment Details

### Docker Compose Location
`/root/services/obsidian-stack/docker-compose.yml`

### Environment Configuration
`/root/services/obsidian-stack/.env`

### Service Management
```bash
cd /root/services/obsidian-stack
docker compose up -d      # Start services
docker compose down       # Stop services
docker compose logs -f    # View logs
docker compose ps         # Check status
```

---

## 🔄 Backup Strategy

### Critical Data
1. **CouchDB Database:** `obsidian-stack_couchdb-data` volume
2. **Configuration:** `/root/services/obsidian-stack/.env`

### Backup Commands
```bash
# Backup CouchDB
docker exec obsidian-couchdb couchdb-backup > couchdb-backup-$(date +%Y%m%d).json

# Backup Vaults
tar -czf obsidian-vaults-backup-$(date +%Y%m%d).tar.gz \
  /var/lib/docker/volumes/obsidian-stack_obsidian-vaults/_data
```

---

## 🧠 Memory Protocol

This vault includes an automated documentation system for AI agents:

1. **Startup Protocol:** Agents MUST read this file before making changes
2. **Shutdown Protocol:** Agents MUST append summaries to `ChangeLog.md`
3. **Context Preservation:** All architectural decisions documented here

---

## 🛠️ Maintenance

### SSL Certificate Renewal
Certificates managed by Certbot (auto-renewal enabled)

### Health Checks
```bash
# Check service health
curl -f http://localhost:8092/_up  # CouchDB

# Check HTTPS endpoints
curl -I https://couchdb.nocturnefox.com
```

---

## 📋 Troubleshooting

### Common Issues

**CouchDB not accessible:**
```bash
docker logs obsidian-couchdb
docker inspect obsidian-couchdb --format='{{.State.Health.Status}}'
```

**Sync issues:**
- Verify CORS is enabled
- Check credentials in Obsidian app
- Ensure internet connection

---

## 🔗 Related Documentation

- `ChangeLog.md` - Development history and changes
- `/root/services/obsidian-stack/README.md` - Setup guide
- `/root/services/obsidian-stack/CLAUDE.md` - AI agent instructions

---

**Last Architecture Review:** 2026-02-12
**Next Review Due:** 2026-03-12