Documentation

AliothPress is a self-hosted CMS built for multilingual websites. Every piece of content — posts, pages, forms, menus, newsletters, legal pages — can be created in one language and translated into any of the 31 supported languages, with full SEO, AEO, and hreflang support out of the box.

The entire admin interface is also translated into all 31 languages, so each team member can work in their preferred language.

Built with Python/Flask. Runs on SQLite or PostgreSQL. Installs in 5 minutes without touching a terminal.

Highlights

  • 31 Languages — content, admin panel, legal pages, setup wizard, and public UI — all fully translated
  • AI Assistant — generate content, translate, optimize SEO — supports Anthropic Claude, DeepSeek, and Google Gemini
  • No Terminal Required — paste a cloud-init script when creating your server, open the browser, done
  • Visual Page Builder — 21 block types: text, images, columns, galleries, slideshows, logo ticker, tables, accordions, forms, and more
  • SEO & AEO out of the box — Schema.org @graph, FAQPage schema, Speakable, /llms.txt, answer-first AI content — optimized for both search engines and AI answer engines
  • Automatic Image Optimization — every upload generates responsive WebP + AVIF variants, OG/Social crops, and dominant color placeholders
  • 15 Designer Themes — each with dark and light mode, switchable from the admin panel
  • Smart Content Protection — automated cleanup of references when content is deleted, automatic 301 redirects when slugs change
  • Built-in Security — CSRF, rate limiting, brute-force protection, HTML/SVG sanitization, security headers, encrypted credentials
  • Privacy-First & GDPR-Ready — zero third-party requests by default, self-hosted fonts and TinyMCE, facade pattern for video embeds (no cookie banner required for the default configuration)
  • Verified Accessibility — 100/100 Accessibility score in Google PageSpeed Insights across all 15 themes in both light and dark modes
  • Fully Responsive — mobile-first design across admin panel and public site

Features

Content Management

  • Posts & Pages with rich HTML editor (TinyMCE)
  • Draft / Published / Scheduled status workflow
  • Tags & Categories with dedicated hub pages
  • Excerpts and Featured Images with alt text and captions
  • Author profiles with display name, bio, and avatar (Schema.org compatible)
  • Canonical URLs to prevent duplicate content
  • FAQ editor per post/page — generates visible FAQ accordion and FAQPage schema for AI citation
  • Show/hide author and date per post/page — metadata always present in HTML for search engines

Multilingual System

  • 31 languages: English, German, French, Spanish, Portuguese, Italian, Dutch, Swedish, Danish, Norwegian, Finnish, Polish, Czech, Slovak, Hungarian, Romanian, Croatian, Bulgarian, Greek, Turkish, Ukrainian, Russian, Arabic, Hebrew, Hindi, Thai, Vietnamese, Indonesian, Chinese, Japanese, Korean
  • Translation groups — link posts, pages, forms, and newsletters across languages with a UUID-based system
  • Per-language menus — header and footer menus automatically resolve to the visitor's language
  • hreflang tags in HTML and sitemap for proper international SEO
  • Language switcher on the public site
  • Per-user admin language — each team member chooses their own interface language
  • Default legal pages created in the selected language during setup (Privacy Policy, Legal Notice, Accessibility)

Visual Page Builder

A block-based editor for pages with live preview. 21 block types:

  • Basic: Heading, Text, Image, Button, Divider, Spacer
  • Structure: Columns (1–4), Section with background
  • Media: Video, Gallery, Video Gallery, Audio, Slideshow, Logo Ticker
  • Advanced: Quote, Table, Accordion/FAQ, Tabs, HTML, Code, Form
  • AI can generate entire page layouts as blocks from a text prompt

AI Assistant

Supports three providers — configure one or all, switch between them at any time:

  • Anthropic Claude (default)
  • DeepSeek
  • Google Gemini

AI capabilities from the admin panel:

  • Generate content — describe what you need, get a full post or page with SEO metadata and FAQ pairs for AI citation
  • Translate content — AI-powered translation linked as a new language version
  • Optimize SEO — generate meta titles, descriptions, keywords, and Open Graph data
  • Generate page layouts — AI creates page builder blocks from a description
  • Conversational mode — refine results through follow-up instructions
  • API keys are stored encrypted (Fernet symmetric encryption)

Media Library

  • Automatic image processing on upload: resize to max dimension, strip EXIF metadata, auto-rotate
  • Responsive variants: WebP and AVIF at multiple breakpoints (400w, 800w, 1200w, 1920w)
  • OG/Social crops: 1200×630 variants in WebP, AVIF, and JPG for Facebook, LinkedIn, Twitter
  • Dominant color extraction for CSS placeholders (prevents Cumulative Layout Shift)
  • srcset generation for <picture> elements — serve the right format and size to every device
  • SVG sanitization — script tags, event handlers, and dangerous elements are stripped on upload
  • Metadata editing: title, caption, description, alt text
  • Grid view with search and pagination

File Manager

Separate from the media library — for documents and downloads:

  • Supported formats: PDF, DOC/DOCX, XLS/XLSX, ZIP, RAR, TXT, CSV
  • Clean download URLs via slugs (e.g., yoursite.com/report.pdf)
  • Title, description metadata
  • File type icons and human-readable sizes
  • Search and pagination

Form Builder

  • Field types: text, email, phone, number, textarea, select, radio, checkbox, date, URL, hidden, rating, consent
  • Honeypot anti-spam protection
  • Double opt-in email confirmation with tokenized links
  • Email notifications on submission (SMTP)
  • Submission management: view, filter by status (new/read/archived/spam), bulk delete
  • CSV export of submissions
  • IP-based rate limiting per form
  • Forms are multilingual — same translation group system as posts/pages
  • Embed forms into pages via the page builder or custom HTML

Newsletter

  • Rich HTML editor for campaign content
  • Audience targeting: by language, by source form, with email exclusions
  • CSV import for external subscriber lists
  • Test send before broadcasting
  • Campaigns are sent only to subscribers who verified their email address
  • Unsubscribe links with HMAC-signed tokens (tamper-proof)
  • Multilingual campaigns — same translation group system
  • Subscribers come from form submissions — no separate subscriber model needed

SEO, AEO & Performance

  • Full meta tag control per post/page: meta title, description, keywords
  • Open Graph tags: og:title, og:description, og:image, og:type
  • Twitter Card tags: twitter:card, twitter:title, twitter:description, twitter:image
  • Schema.org @graph — interconnected Organization, Person, and Article entities with sameAs links to Wikipedia, Wikidata, LinkedIn, and social profiles for AI entity verification
  • FAQPage schema — auto-generated from FAQ editor and Page Builder accordion blocks; research shows ~41% AI citation rate vs ~15% without
  • Speakable schema — marks key content as suitable for voice assistants and AI answer extraction
  • /llms.txt — auto-generated AI-friendly site summary following the llmstxt.org standard, with multilingual content grouped by language
  • Answer-first AI content — AI Assistant generates content with direct answers in the first 150 words, optimized for AI citation
  • Automatic XML sitemap with hreflang alternate links and XSL stylesheet
  • Editable robots.txt from the admin panel (AI crawlers allowed by default, llms.txt auto-linked)
  • RSS/Atom feeds with multilingual support (/feed, /feed/de, /feed/es)
  • Automatic 301 redirects when a post or page slug is changed — redirect chains are flattened (A→B→C becomes A→C + B→C)
  • Smart cache headers: immutable for static files, short cache with CDN support for public pages, no-cache for admin
  • Static file cache busting — automatic ?v= timestamp parameter on CSS/JS/images
  • Automatic cleanup of broken references — when you delete an image, file, form, or page, all references to it in other content (posts, pages, page builder blocks, menus) are automatically removed

Themes

  • 15 designer themes included, each with dark and light mode
  • Default display mode: dark, light, or auto (follows system preference)
  • Theme preview images in the admin panel
  • Themes are pure CSS — no build step, no JavaScript framework required
  • Theme descriptions are translated via i18n
  • Two locations: header, footer
  • Hierarchical menus with parent-child relationships (submenus)
  • Link to posts, pages, or custom/external URLs
  • Per-language labels — each menu item can have a different label per language (JSON-stored)
  • Automatic language resolution — when a visitor views a German page, menu links to posts/pages resolve to their German translations if available
  • Drag-and-drop ordering
  • Active/inactive toggle, CSS class support, target (_self/_blank)

User Management

  • Three roles: Owner (site creator), Admin (full access), Editor (content only)
  • Email invitations with tokenized signup links and expiry
  • Password policy: configurable minimum length, uppercase, lowercase, digit requirements
  • Password reset via email with time-limited tokens
  • Account deactivation without deletion
  • Session invalidation on password change (version counter forces re-login)
  • Per-user admin theme preference: light, dark, or system
  • Author profiles: display name, bio, avatar URL, LinkedIn/website/GitHub links (used in Schema.org sameAs for AI entity verification)

Security

  • CSRF protection on all forms (Flask-WTF, 1-hour token validity)
  • Rate limiting (Flask-Limiter): 200 req/min global, stricter limits on login, AI, SSL, and form endpoints
  • Brute-force protection: IP blocked after 5 failed logins in 15 minutes
  • HTML sanitization on all editor content (bleach — allowlisted tags and attributes)
  • SVG sanitization: strips <script>, event handlers, javascript: URLs, <foreignObject>, external references
  • Security headers: X-Frame-Options, X-Content-Type-Options, X-XSS-Protection, Referrer-Policy, Permissions-Policy, HSTS
  • Open redirect prevention — next-URL validation on login
  • Encrypted credential storage — SMTP passwords, API keys, and license keys encrypted with Fernet (derived from SECRET_KEY)
  • License integrity verification — HMAC signature prevents database tampering
  • Audit log — every significant admin action is recorded with user, IP, timestamp, and translated details
  • Session security: HTTP-only cookies, SameSite=Lax, 12-hour lifetime

Backup & Restore

  • One-click backup from the admin panel — creates a ZIP archive with:
    • Database dump (SQLite file or PostgreSQL pg_dump)
    • All uploaded files (images, documents, favicons)
    • .env configuration (with sensitive values automatically masked)
  • Restore from backup — upload a ZIP, select what to restore
  • Supports both SQLite and PostgreSQL backup/restore

Favicon Generator

  • Upload favicon from the admin panel
  • Automatic generation of all required sizes and formats
  • Supports ICO, PNG, SVG source files

SSL / HTTPS

  • One-click Let's Encrypt setup from the admin panel
  • Domain validation with DNS check
  • Delegated to a secure system script (Flask never writes nginx config directly)
  • Rate limited (5 per hour)
  • Logged to audit log

Licensing & Updates

  • Free for non-commercial use — personal sites, blogs, educational projects, non-profits
  • License key required for commercial use — one key per domain
  • Licensed sites get: no "Powered by" attribution, automatic updates
  • Built-in update system: check for updates and apply them from Settings
  • License validation against update server with periodic re-checks (every 7 days)
  • Tamper-evident license storage (HMAC-signed)

Privacy & GDPR

AliothPress is built privacy-first and ships with zero third-party requests by default. This is a deliberate design choice to make the CMS easy to deploy in jurisdictions with strict data protection regulations — particularly the EU (GDPR, ePrivacy), Germany (TTDSG), the UK (UK GDPR), and Switzerland (revDSG).

Zero external requests on page load. A default AliothPress site makes no HTTP requests to any third-party domain when a visitor opens a page. No Google Fonts, no CDN scripts, no analytics trackers, no embed iframes. This means:

  • No visitor IP addresses are shared with third parties without explicit consent
  • No cookie consent banner is required for the default configuration
  • No Data Processing Agreements (DPAs) needed beyond your own hosting provider

Self-hosted assets:

  • Web fonts — 12 font families are served per-subset from /static/fonts/ as WOFF2 files. Browsers download only the glyph subsets actually used on each page. Zero requests to Google Fonts, Adobe Fonts, or any font CDN. This follows the guidance from the LG München I Google Fonts ruling (Az. 3 O 17493/20, January 2022), which established that sending visitor IP addresses to Google Fonts without consent is a GDPR violation.
  • Rich text editor (TinyMCE) — TinyMCE is self-hosted in the admin panel. No calls to tiny.cloud for UI, toolbar icons, plugins, or telemetry. API-key-less community build. This matters because the stock TinyMCE CDN integration sends editor usage data to tiny.cloud, which would make the admin panel alone require a DPA.
  • Syntax highlighting (Prism.js) — Self-hosted at /static/js/prism/. No cdnjs calls.
  • Images — All images uploaded through the media library are processed server-side (resized, EXIF-stripped, converted to WebP/AVIF) and served from your own domain. No image CDNs.
  • Favicons & admin icons — Inline SVG or self-hosted. No icon fonts from CDNs.

Video embeds (YouTube / Vimeo) — facade pattern. Embedded videos use a privacy-preserving two-click approach:

  1. On initial page load, the visitor sees a locally-cached thumbnail served from your own domain. Zero requests to youtube.com, youtube-nocookie.com, i.ytimg.com, vimeo.com, or player.vimeo.com.
  2. The video iframe is loaded only after the visitor explicitly clicks the play button, which constitutes active consent under GDPR Art. 6(1)(a) and §25 TTDSG.
  3. Thumbnails are fetched server-side once from the provider's official oEmbed endpoint, cached on disk in /static/uploads/video-thumbs/, and served as regular static files with long cache headers.

Video titles that appear in the admin panel (auto-fetched on paste) also go through the server — the admin's browser never talks directly to Google or Vimeo. This approach follows the recommendations of German data protection authorities (DSK, BayLDA, LfDI Baden-Württemberg) for embedding third-party video content without requiring a cookie consent banner for the video block itself.

AI Assistant — When enabled, AI requests are made server-to-server from your server to the configured provider (Anthropic Claude, DeepSeek, or Google Gemini). Visitor IP addresses and browser data are never forwarded to the AI provider. API keys are stored encrypted (Fernet symmetric encryption derived from SECRET_KEY).

Forms — No third-party CAPTCHA (no Google reCAPTCHA, no hCaptcha). Spam protection is handled via honeypot fields and IP-based rate limiting, both fully self-contained. Double opt-in email confirmation uses HMAC-signed tokens generated on your own server.

Analytics are opt-in. Google Analytics and Google Tag Manager are disabled by default. If the site operator chooses to enable them in Settings, displaying a cookie consent banner becomes their responsibility — but the default configuration never triggers this requirement.

Audit log — Records admin actions (user, IP, timestamp, translated action description) for security purposes. Contains no visitor data and is accessible only to admin users.

For site operators

AliothPress provides a technical guarantee about how the software behaves. The responsibility to publish an accurate Datenschutzerklärung (privacy policy) on your live site still rests with you as the site operator.

Note: The description above is a technical statement about how the software behaves, not legal advice. For production deployment in a commercial context, consider a one-time review by a qualified IT law attorney.

Accessibility

  • All 15 designer themes tested for accessibility in both light and dark modes
  • 100/100 Accessibility score in Google PageSpeed Insights across all 15 themes in both modes
  • Self-hosted fonts and icons — no external CDNs, no font-swap layout shifts
  • prefers-reduced-motion respected — disables slideshow autoplay, ticker scroll, and scroll-triggered animations
  • prefers-color-scheme drives automatic dark/light mode when the theme default is "auto"
  • Keyboard navigation in custom components — video facade (native <button>), slideshow (arrow keys), lightbox (Escape), accordion (native <details>)
  • <html lang=""> set per page based on content language; hreflang alternates in HTML and sitemap
  • RTL layout for Arabic and Hebrew content

Installation

AliothPress installs without a terminal. Create a cloud server (Hetzner, DigitalOcean, Linode, Vultr), paste the provided cloud-init script, and open your browser. The Setup Wizard handles everything else:

  1. Choose your language
  2. Choose a database (SQLite for simplicity, PostgreSQL for scale)
  3. Create your admin account
  4. Name your site and enter your license key (optional)

See the Installation Guide for detailed step-by-step instructions with screenshots.

Server requirements: Ubuntu 22.04, 24.04 or 26.04, 2 vCPU, 4 GB RAM. On Hetzner: CX23 (Cost-Optimized, ~€4–5/mo) for personal projects, or CPX22 (Regular Performance, ~€7–8/mo) for business use.

Project Structure

aliothpress/
├── app.py                          # Application core — routes, logic, API
├── config.py                       # Configuration (DB, uploads, image processing, security)
├── models.py                       # Database models (13 models)
├── block_renderer.py               # Page builder block rendering engine
├── schema_org.py                   # Schema.org JSON-LD graph builders (SEO structured data)
├── i18n.py                         # Internationalization system
├── updater.py                      # License validation & update system
├── install.py                      # Installation helpers
├── requirements.txt                # Python dependencies
├── .env                            # Environment variables (secrets, DB URI)
├── .env.example                    # Example environment file
│
├── static/
│   ├── js/
│   │   ├── public.js               # Public site scripts
│   │   ├── page-builder-public.js  # Page builder frontend rendering
│   │   ├── admin-image-picker.js   # Shared media library picker (admin)
│   │   └── prism/                  # Self-hosted Prism.js (syntax highlighting)
│   │
│   ├── css/
│   │   ├── core.css                # Core styles
│   │   ├── admin.css               # Admin panel styles
│   │   ├── components.css          # UI components
│   │   ├── typography.css          # Typography system
│   │   ├── responsive.css          # Responsive breakpoints & mobile styles
│   │   ├── setup.css               # Setup wizard styles
│   │   ├── page-builder-blocks.css # Page builder block styles
│   │   ├── page-builder-editor.css # Page builder editor UI
│   │   └── themes/                 # 15 designer themes
│   │       ├── stellar-origin/
│   │       │   ├── theme.css       # Theme styles (dark + light mode)
│   │       │   └── preview.svg     # Theme preview image
│   │       └── ... (14 more themes)
│   │
│   ├── i18n/
│   │   ├── en.json                 # English admin translations
│   │   ├── public.json             # Public site translations
│   │   ├── setup.json              # Setup wizard translations
│   │   ├── default_pages.json      # Default legal page content
│   │   └── ... (30 more language files — 31 languages total)
│   │
│   ├── legal/
│   │   ├── eula_en.html            # EULA in English
│   │   └── ... (30 more languages — 31 EULA files total)
│   │
│   ├── img/
│   │   └── ...                     # Admin UI icons and static assets
│   │
│   ├── fonts/                      # Self-hosted web fonts (per-subset WOFF2, GDPR-friendly)
│   │   ├── inter/
│   │   ├── outfit/
│   │   └── ... (12 font families, split by subset — browsers download only what's used)
│   │
│   ├── uploads/
│   │   ├── favicon/                # Uploaded favicon files
│   │   └── files/                  # Uploaded documents (PDF, DOCX, etc.)
│   │
│   └── sitemap.xsl                 # XSL stylesheet for XML sitemap
│
└── templates/
    ├── setup.html                  # Installation wizard
    │
    ├── components/
    │   └── admin-bar.html          # Admin toolbar component
    │
    ├── admin/
    │   ├── base.html               # Admin layout base template
    │   ├── dashboard.html          # Dashboard with stats overview
    │   ├── login.html              # Login page
    │   ├── settings.html           # Site settings (identity, SEO, AEO, social, email)
    │   ├── themes.html             # Theme browser & activation
    │   ├── menus.html              # Menu editor (header, footer, sidebar)
    │   ├── ai.html                 # AI Assistant settings & tools
    │   ├── tools.html              # SEO & AEO tools (sitemap, robots.txt, llms.txt)
    │   ├── users.html              # User management & invitations
    │   ├── profile.html            # User profile editor
    │   ├── audit_log.html          # Security audit log viewer
    │   ├── backup.html             # Backup & restore
    │   ├── accept_invite.html      # Team invitation acceptance
    │   ├── forgot_password.html    # Password reset request
    │   ├── reset_password.html     # Password reset form
    │   │
    │   ├── posts/
    │   │   ├── list.html           # Posts list with search & filters
    │   │   ├── new.html            # Create new post
    │   │   ├── edit.html           # Edit post (with SEO panel)
    │   │   └── translate.html      # Translation editor
    │   │
    │   ├── pages/
    │   │   ├── list.html           # Pages list
    │   │   ├── new.html            # Create new page
    │   │   ├── edit.html           # Edit page
    │   │   ├── translate.html      # Translation editor
    │   │   └── builder.html        # Visual page builder
    │   │
    │   ├── forms/
    │   │   ├── list.html           # Forms list
    │   │   ├── new.html            # Create new form
    │   │   ├── edit.html           # Edit form & fields
    │   │   ├── submissions.html    # Form submissions list
    │   │   └── submission_detail.html  # Individual submission view
    │   │
    │   ├── newsletter/
    │   │   ├── list.html           # Newsletter campaigns list
    │   │   ├── new.html            # Create new campaign
    │   │   ├── edit.html           # Edit campaign content
    │   │   └── translate.html      # Translation editor
    │   │
    │   ├── media/
    │   │   ├── library.html        # Media library grid view
    │   │   ├── upload.html         # Image upload
    │   │   ├── edit.html           # Image metadata editor
    │   │   └── favicon.html        # Favicon manager
    │   │
    │   └── files/
    │       ├── list.html           # File manager list
    │       ├── upload.html         # File upload
    │       └── edit.html           # File metadata editor
    │
    └── public/
        ├── base.html               # Public site base layout
        ├── index.html              # Homepage (post listing)
        ├── post.html               # Single post template
        ├── page.html               # Single page template
        ├── tag.html                # Posts filtered by tag
        ├── tags_hub.html           # All tags overview
        ├── categories_hub.html     # All categories overview
        ├── message.html            # System messages (confirmation, unsubscribe)
        └── 404.html                # Custom 404 page

License

AliothPress is proprietary software. Free for non-commercial use. A license key is required for commercial use. See the End-User License Agreement for full terms.

Tech Stack

  • Backend: Python 3, Flask, SQLAlchemy, Flask-Login, Flask-WTF, Flask-Limiter
  • Database: SQLite (default) or PostgreSQL
  • Image Processing: Pillow (WebP, AVIF, resize, EXIF strip, color extraction)
  • Editor: TinyMCE (rich HTML editing)
  • AI: Anthropic, DeepSeek, Google Gemini APIs (HTTP, no SDK dependency)
  • Security: bleach, cryptography (Fernet), HMAC, bcrypt
  • Frontend: Vanilla JS, CSS custom properties, no framework dependency

Supported Languages

Admin interface, public UI, legal pages, and setup wizard — all fully translated:

ar bg cs da de el en es fi fr he hi hr hu id it ja ko nb nl pl pt ro ru sk sv th tr uk vi zh