Errordon

---

🛡️ A Safe Fediverse Instance for European Law Compliance

Errordon is a Mastodon fork designed for instance operators who want to run a legally compliant social media platform under European and German law — with AI-assisted content moderation.

---

📸 Screenshots

Profile View with Media Tabs

Live Feeds with Matrix Rain

---

🚫 ZERO TOLERANCE POLICY

🔞 NO PORN Every upload is automatically scanned by AI. Pornographic content is immediately deleted and accounts are frozen.

🚫 NO HATE Hate speech, antisemitism, and incitement (§130 StGB) trigger automatic review and escalating bans.

⛔ NO FASCISM Nazi symbols, Holocaust denial, and unconstitutional content (§86a StGB) result in permanent bans.

---

🤖 NSFW-Protect AI System

Errordon includes a revolutionary AI-powered content moderation system that helps instance administrators enforce European law with minimal manual effort. It is optionional - you can install with or with out. The deploy scripts let you choose. But I thought Porn-Filter would be a need.

Here some Thoughts about the wide Range of AI-Usecases - from helping handicaped people to masssurveilance and masskilling weapons.

A call to look closer and not stay shortminded: https://hearthis.at/lino.casu/ai-lino/

How It Works

┌───────────────────────────────────────────────────────────────────────────┐
│                        NSFW-PROTECT AI PIPELINE                           │
├───────────────────────────────────────────────────────────────────────────┤
│                                                                           │
│   📤 UPLOAD                    🤖 AI ANALYSIS                            │
│   ───────────                  ──────────────                             │
│   User uploads                 Ollama AI checks:                          │
│   image/video                  • Pornographic content                     │
│         │                      • Hate symbols                             │
│         ▼                      • Illegal material                         │
│   ┌─────────────┐                     │                                   │
│   │  INTERCEPT  │────────────────────▶│                                   │
│   └─────────────┘                     ▼                                   │
│                              ┌────────────────┐                           │
│                              │  SAFE? ──▶ ✅   │                         │
│                              │  PORN? ──▶ 🚫   │──▶ Auto-delete + Strike │
│                              │  HATE? ──▶ 🚫   │──▶ Review + Strike      │
│                              │  CSAM? ──▶ 🚨   │──▶ Ban + Authorities    │
│                              └────────────────┘                           │
│                                                                           │
└───────────────────────────────────────────────────────────────────────────┘

Strike System (Escalating Consequences)

Strike	Porn Violation	Hate Violation
1st	24 hours freeze	Warning + Review
2nd	3 days freeze	3 days freeze
3rd	7 days freeze	7 days freeze
4th	30 days freeze	PERMANENT
5th+	PERMANENT	—

Scheduled Jobs (automatic via Sidekiq)

Job	Schedule	Purpose
Blocklist Update	3:00 AM	Update porn domain list
GDPR Cleanup	4:00 AM	Delete expired data, anonymize IPs
AI Snapshot Cleanup	4:30 AM	Delete SAFE snapshots after 14 days
Video Cleanup	5:00 AM	Shrink old videos to 480p
Freeze Cleanup	Hourly	Unfreeze expired accounts
Weekly Summary	Mon 9 AM	Email stats to admin

Instance-Wide Protection

• 10+ active alarms → Instance posting freeze for flagged accounts
• CSAM detection → Immediate permanent ban + law enforcement notification
• Admin email alerts → Real-time notifications for all violations

---

⚖️ Legal Framework (German/EU Law)

This instance software is designed to help operators comply with:

Law	Description	Errordon Response
§130 StGB	Volksverhetzung (Incitement)	AI detection + auto-ban
§184b StGB	Child pornography	Immediate ban + authorities
§86a StGB	Unconstitutional symbols	AI detection + permanent ban
§131 StGB	Glorification of violence	AI review + escalating bans
NetzDG	Network Enforcement Act	IP logging, content removal
DSGVO/GDPR	Data protection	Privacy-first defaults

Legal Documents Included

• ✅ Terms of Service (German law compliant)
• ✅ Privacy Policy (DSGVO/GDPR compliant)
• ✅ Community Guidelines (Clear rules with legal references)

---

🔐 Registration Security

Errordon supports invite-only registration with mandatory checks:

┌───────────────────────────────────────────┐
│         REGISTRATION FLOW               │
├───────────────────────────────────────────┤
│  1. ✉️  Invite Code Required             │
│     └─ Max 3 uses per code                │
│                                           │
│  2. 🔞 Age Verification                  │
│     └─ Checkbox: "I am 18 or older"       │
│                                           │
│  3. 📜 Legal Acceptance                  │
│     └─ Terms of Service                   │
│     └─ Privacy Policy                     │
│     └─ Community Guidelines               │
│                                           │
│  4. ✅ Email Verification                │
└──────────────────────────────────────────┘

---

🚀 Quick Start

Enable NSFW-Protect AI

# Install Ollama for AI content moderation
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llava    # Vision model for images/videos
ollama pull llama3   # Text model for hate speech

# Enable in .env.production
ERRORDON_NSFW_PROTECT_ENABLED=true
ERRORDON_NSFW_OLLAMA_ENDPOINT=http://localhost:11434
ERRORDON_NSFW_ADMIN_EMAIL=admin@your-instance.com
ERRORDON_INVITE_ONLY=true
ERRORDON_REQUIRE_AGE_18=true

One-Line Installation (Docker-based)

curl -fsSL https://raw.githubusercontent.com/error-wtf/errordon/main/install-docker.sh -o install-docker.sh
bash install-docker.sh

Why this way: piping into bash can break interactive prompts on some terminals because stdin is not a TTY (you can end up typing into your shell instead of the installer). Downloading first keeps the installer fully interactive and makes failures (like 404) obvious.

Interactive prompts for:

• Domain & Admin Email
• Admin Username
• SMTP Configuration
• Matrix Terminal Theme
• Ollama AI (NSFW-Protect)

Manual Docker Setup

git clone https://github.com/error-wtf/errordon.git
cd errordon
bash install-docker.sh

---

✨ Additional Features

Beyond legal compliance, Errordon includes:

Feature	Description
🎬 Profile Media Tabs	Separate Videos/Audio/Images tabs
🎨 Matrix Theme	Cyberpunk green UI (Ctrl+Shift+M)
🖥️ Matrix Terminal	Interactive landing page with games
😎 165 Custom Emojis	Matrix/Hacker/Nerd/CCC/DevOps/Security themed
📤 99MB Uploads	With server-side transcoding
🔒 Privacy-First	Strict defaults via ENV
💾 Dynamic Storage Quota	60% disk shared equally, profile display
🔍 Media Filters	Originals only, Alt text, Public
📹 Auto Video Cleanup	Shrink videos >7 days to 480p
🗑️ GDPR Compliance	Auto-delete expired data
📧 Evidence Emails	Forensic reports for violations

---

🎨 Matrix Theme

Errordon includes an optional Matrix-style cyberpunk theme with:

• Green neon color palette (#00ff00)
• VT323 hacker font for headings (UTF-8 compatible)
• Glitch effects on hover
• Dark background with white text for readability
• 100% Fediverse-compatible (opt-in, no structural changes)

Toggle Theme

Keyboard: Ctrl + Shift + M

Or set default via environment:

ERRORDON_THEME=matrix  # Options: matrix, default, light

😎 Custom Emojis

127 Matrix/Hacker/Nerd/CCC/DevOps/Security themed emojis in 14 categories:

Category	Emojis
Matrix	:matrix_code: :red_pill: :blue_pill: :skull_matrix: :matrix_cat: :glitch: :neon: :synthwave: :hologram:
Hacker	:hacker: :terminal: :binary: :encrypt: :access_granted: :access_denied: :anonymous: :wifi_hack: :firewall: :sudo: :tor: :vpn: :ssh: :darknet: :exploit: :overflow: :injection: :phishing:
Nerd	:nerd: :keyboard: :code: :bug: :cyber_eye: :robot: :coffee_code: :git: :loading: :hacker_cat: :night_owl: :headphones:
Coding	:python: :javascript: :rust: :docker: :linux: :vim: :emacs: :api: :json: :regex: :null: :undefined: :commit: :merge: :branch: :pull_request: :opensource: :foss: :debug: :segfault: :bash: :zsh: :root: :chmod: :ping: :404: :500: :200:
Hardware	:cpu: :ram: :gpu: :server: :database: :raspberry_pi: :arduino: :usb: :ethernet:
Coffee	:coffee: :espresso: :latte: :energy_drink: :pizza:
CCC	:ccc: :chaos: :hackspace: :soldering:
Cyberpunk	:cyborg: :ai: :neural: :blockchain: :crypto: :vr: :retro: :pixel: :arcade: :gamepad:

Import Emojis

bundle exec rails errordon:import_emojis

🔧 API Endpoints

Errordon-specific APIs

Endpoint	Method	Description
/api/v1/errordon/quotas/current	GET	Current user's quota stats
/api/v1/errordon/storage_quota	GET	Dynamic disk-based quota
/api/v1/errordon/quotas	GET	Admin: All user quotas
/api/v1/errordon/quotas/:id	GET/PUT	Admin: User quota details/update
/api/v1/errordon/transcoding/:media_id/status	GET	Transcoding status for media

Enhanced Mastodon APIs

Endpoint	Enhancement
/api/v1/accounts/:id/statuses	New media_type param: video|audio|image

🎯 Goals

• Profile Media Columns: Separate tabs for Videos, Audio, Images in user profiles
• Filter UI: Filter by "originals only", "with alt text", visibility
• Large Uploads: Up to 250MB for video/audio with automatic transcoding
• Privacy Defaults: Strict preset inspired by chaos.social principles

📁 Repository Structure

errordon/
├── app/
│   ├── controllers/api/v1/errordon/     # Errordon API controllers
│   │   ├── quotas_controller.rb          # Quota management
│   │   └── transcoding_controller.rb     # Transcoding status
│   ├── services/errordon/               # Business logic
│   │   ├── storage_quota_service.rb      # Dynamic disk quotas
│   │   ├── media_upload_checker.rb       # NSFW-Protect AI
│   │   ├── domain_blocklist_service.rb   # Porn/fascism blocklist
│   │   ├── security_service.rb           # File validation
│   │   ├── audit_logger.rb               # Security logging
│   │   └── video_transcoder_service.rb   # Video transcoding
│   ├── workers/errordon/                # Background jobs
│   │   └── media_transcode_worker.rb     # Sidekiq worker
│   └── javascript/
│       ├── mastodon/features/errordon/   # React components
│       │   ├── matrix_theme.ts           # Theme controller
│       │   ├── admin_quotas.tsx          # Admin UI
│       │   └── video_grid.tsx            # Video grid
│       └── styles/errordon_matrix.scss   # Matrix theme styles
├── config/
│   ├── initializers/errordon_*.rb       # Feature configs
│   ├── routes/errordon.rb               # API routes
│   └── locales/errordon.*.yml           # Translations
├── public/emoji/errordon/               # 127 custom SVG emojis
├── lib/tasks/errordon_emojis.rake       # Emoji import task
├── deploy/                              # Production configs
├── docs/                                # Documentation
└── spec/initializers/                   # Tests

---

📖 Documentation

Getting Started

Document	Description
🚀 Deployment Guide	Complete production deployment
📚 Tutorials	Step-by-step guides
⚙️ Configuration	All environment variables
🔧 Troubleshooting	Common issues & solutions

Technical Documentation

Document	Description
NSFW_PROTECT_ARCHITECTURE.md	AI moderation system details
STORAGE_QUOTA.md	Dynamic disk-based quotas
GDPR_COMPLIANCE.md	Data retention & privacy
VIDEO_CLEANUP.md	Auto video shrinking
TRANSCODING_PIPELINE.md	Media transcoding
SECURITY.md	Security best practices

Legal Documents

Document	Description
Terms of Service	Legal terms (DE/EN)
Privacy Policy	DSGVO/GDPR compliant
Community Guidelines	Rules with legal references

Contributing

Document	Description
Contributing Guide	How to contribute
Changelog	Version history & changes

---

🏛️ Why This Exists

Running a social media instance in Germany/EU comes with legal responsibilities:

• NetzDG requires removal of illegal content within 24 hours
• §184b StGB criminalizes hosting of CSAM
• §130 StGB prohibits hosting hate speech and incitement
• Instance operators can be held personally liable

Errordon helps you comply by automating detection and enforcement — so you can run a safe community without becoming a full-time moderator.

---

🤝 For Instance Operators

This software is for you if:

• ✅ You want to run a safe, family-friendly Fediverse instance
• ✅ You want EU/German law compliance out of the box
• ✅ You want AI assistance for content moderation
• ✅ You want clear legal documents for your users
• ✅ You believe in free speech within the law (no fascism, no porn, no hate)

---

📜 License

AGPLv3 - Compatible with Mastodon's license.

All Errordon additions are also AGPLv3.

---

🔗 Links

• Mastodon - Upstream project
• Ollama - AI backend for NSFW-Protect
• German Criminal Code (StGB) - Legal framework

---

Errordon — A Safe Fediverse for Europe 🇪🇺🇩🇪

NO PORN • NO HATE • NO FASCISM