#####
#
# Example .htaccess file for TYPO3 CMS - for use with Apache Webserver
#
# This file includes settings for the following configuration options:
#
# - Compression
# - Caching
# - MIME types
# - Cross Origin requests
# - Rewriting and Access
# - Miscellaneous
# - PHP optimisation
#
# If you want to use it, you have to copy it to the root folder of your TYPO3 installation (if its
# not there already) and rename it to '.htaccess'. To make .htaccess files work, you might need to
# adjust the 'AllowOverride' directive in your Apache configuration file.
#
# IMPORTANT: You may need to change this file depending on your TYPO3 installation!
# Consider adding this file's content to your webserver's configuration directly for speed improvement
#
# Lots of the options are taken from https://github.com/h5bp/html5-boilerplate/blob/master/dist/.htaccess
#
####
### Begin: Compression ###
# Compressing resource files will save bandwidth and so improve loading speed especially for users
# with slower internet connections. TYPO3 can compress the .js and .css files for you.
# *) Uncomment the following lines and
# *) Set $GLOBALS['TYPO3_CONF_VARS']['BE']['compressionLevel'] = 9 for the Backend
# *) Set $GLOBALS['TYPO3_CONF_VARS']['FE']['compressionLevel'] = 9 together with the TypoScript properties
# config.compressJs and config.compressCss for GZIP compression of Frontend JS and CSS files.
#
# AddType "text/javascript" .gz
#
#
# AddType "text/css" .gz
#
#AddEncoding x-gzip .gz
# Force compression for mangled `Accept-Encoding` request headers
SetEnvIfNoCase ^(Accept-EncodXng|X-cept-Encoding|X{15}|~{15}|-{15})$ ^((gzip|deflate)\s*,?\s*)+|[X~-]{4,13}$ HAVE_Accept-Encoding
RequestHeader append Accept-Encoding "gzip,deflate" env=HAVE_Accept-Encoding
# Compress all output labeled with one of the following media types.
#
# (!) For Apache versions below version 2.3.7 you don't need to
# enable `mod_filter` and can remove the ``
# and `` lines as `AddOutputFilterByType` is still in
# the core directives.
#
# https://httpd.apache.org/docs/current/mod/mod_filter.html#addoutputfilterbytype
AddOutputFilterByType DEFLATE application/atom+xml \
application/javascript \
application/json \
application/ld+json \
application/manifest+json \
application/rdf+xml \
application/rss+xml \
application/schema+json \
application/vnd.geo+json \
application/geo+json \
application/vnd.ms-fontobject \
application/x-font-ttf \
application/x-javascript \
application/x-web-app-manifest+json \
application/xhtml+xml \
application/xml \
font/eot \
font/opentype \
font/otf \
font/ttf \
image/bmp \
image/svg+xml \
image/vnd.microsoft.icon \
image/x-icon \
text/cache-manifest \
text/css \
text/html \
text/javascript \
text/plain \
text/vcard \
text/vnd.rim.location.xloc \
text/vtt \
text/x-component \
text/x-cross-domain-policy \
text/xml
AddEncoding gzip svgz
### End: Compression ###
### Begin: Immutable processed images (SEO/Lighthouse 2026-11-10) ###
# Files below fileadmin/_processed_/ carry a content hash in their name and
# never change in place - a year of immutable caching is safe and removes the
# "uses-long-cache-ttl" findings (mod_expires below sets only one month).
Header set Cache-Control "max-age=31536000, immutable"
### End: Immutable processed images ###
### Begin: Browser caching of resource files ###
# This affects Frontend and Backend and increases performance.
ExpiresActive On
ExpiresDefault "access plus 1 month"
ExpiresByType text/css "access plus 1 year"
ExpiresByType application/json "access plus 0 seconds"
ExpiresByType application/ld+json "access plus 0 seconds"
ExpiresByType application/schema+json "access plus 0 seconds"
ExpiresByType application/vnd.geo+json "access plus 0 seconds"
ExpiresByType application/geo+json "access plus 0 seconds"
ExpiresByType application/xml "access plus 0 seconds"
ExpiresByType text/xml "access plus 0 seconds"
ExpiresByType image/vnd.microsoft.icon "access plus 1 week"
ExpiresByType image/x-icon "access plus 1 week"
ExpiresByType text/x-component "access plus 1 month"
ExpiresByType text/html "access plus 0 seconds"
ExpiresByType application/javascript "access plus 1 year"
ExpiresByType application/x-javascript "access plus 1 year"
ExpiresByType text/javascript "access plus 1 year"
ExpiresByType application/manifest+json "access plus 1 week"
ExpiresByType application/x-web-app-manifest+json "access plus 0 seconds"
ExpiresByType text/cache-manifest "access plus 0 seconds"
ExpiresByType audio/ogg "access plus 1 month"
ExpiresByType image/apng "access plus 1 month"
ExpiresByType image/avif "access plus 1 month"
ExpiresByType image/avif-sequence "access plus 1 month"
ExpiresByType image/bmp "access plus 1 month"
ExpiresByType image/gif "access plus 1 month"
ExpiresByType image/jpeg "access plus 1 month"
ExpiresByType image/jxl "access plus 1 month"
ExpiresByType image/png "access plus 1 month"
ExpiresByType image/svg+xml "access plus 1 month"
ExpiresByType image/webp "access plus 1 month"
ExpiresByType video/mp4 "access plus 1 month"
ExpiresByType video/ogg "access plus 1 month"
ExpiresByType video/webm "access plus 1 month"
ExpiresByType application/atom+xml "access plus 1 hour"
ExpiresByType application/rdf+xml "access plus 1 hour"
ExpiresByType application/rss+xml "access plus 1 hour"
ExpiresByType font/collection "access plus 1 month"
ExpiresByType application/vnd.ms-fontobject "access plus 1 month"
ExpiresByType font/eot "access plus 1 month"
ExpiresByType font/opentype "access plus 1 month"
ExpiresByType font/otf "access plus 1 month"
ExpiresByType application/x-font-ttf "access plus 1 month"
ExpiresByType font/ttf "access plus 1 month"
ExpiresByType application/font-woff "access plus 1 month"
ExpiresByType application/x-font-woff "access plus 1 month"
ExpiresByType font/woff "access plus 1 month"
ExpiresByType application/font-woff2 "access plus 1 month"
ExpiresByType font/woff2 "access plus 1 month"
ExpiresByType text/x-cross-domain-policy "access plus 1 week"
### End: Browser caching of resource files ###
### Begin: MIME types ###
# Proper MIME types for all files
# Security configuration
RemoveType .html .htm
AddType text/html .html .htm
RemoveType .svg .svgz
AddType image/svg+xml .svg .svgz
# Data interchange
AddType application/atom+xml atom
AddType application/json json map topojson
AddType application/ld+json jsonld
AddType application/rss+xml rss
AddType application/vnd.geo+json geojson
AddType application/xml rdf xml
# JavaScript
AddType application/javascript js mjs
# Manifest files
AddType application/manifest+json webmanifest
AddType application/x-web-app-manifest+json webapp
AddType text/cache-manifest appcache
# Media files
AddType audio/mp4 f4a f4b m4a
AddType audio/ogg oga ogg opus
AddType image/avif avif
AddType image/avif-sequence avifs
AddType image/bmp bmp
AddType image/jxl jxl
AddType image/webp webp
AddType video/mp4 f4v f4p m4v mp4
AddType video/ogg ogv
AddType video/webm webm
AddType video/x-flv flv
AddType image/x-icon cur ico
# Web fonts
AddType font/woff woff
AddType font/woff2 woff2
AddType application/vnd.ms-fontobject eot
AddType font/ttf ttc ttf
AddType font/otf otf
# Other
AddType application/octet-stream safariextz
AddType application/x-bb-appworld bbaw
AddType application/x-chrome-extension crx
AddType application/x-opera-extension oex
AddType application/x-xpinstall xpi
AddType text/vcard vcard vcf
AddType text/vnd.rim.location.xloc xloc
AddType text/vtt vtt
AddType text/x-component htc
# UTF-8 encoding
AddDefaultCharset utf-8
AddCharset utf-8 .atom .css .js .json .manifest .rdf .rss .vtt .webapp .webmanifest .xml
### End: MIME types ###
### Begin: Cross Origin ###
# Send the CORS header for images when browsers request it.
SetEnvIf Origin ":" IS_CORS
Header set Access-Control-Allow-Origin "*" env=IS_CORS
# Allow cross-origin access to web fonts.
Header set Access-Control-Allow-Origin "*"
### End: Cross Origin ###
### Begin: Rewriting and Access ###
# Enable URL rewriting
RewriteEngine On
# Store the current location in an environment variable CWD to use
# mod_rewrite in .htaccess files without knowing the RewriteBase
RewriteCond $0#%{REQUEST_URI} ([^#]*)#(.*)\1$
RewriteRule ^.*$ - [E=CWD:%2]
# robots.txt per host: the Sitemap directive must be an absolute URL on the
# crawled host, so dev serves its own file (Seobility found "0 sitemaps"
# because robots.txt pointed at www.vitec.com). SEO audit 2026-11-10.
RewriteCond %{HTTP_HOST} ^dev\.vitec\.com$ [NC]
RewriteRule ^robots\.txt$ robots-dev.txt [L]
# Rules to set ApplicationContext based on hostname
#RewriteCond %{HTTP_HOST} ^dev\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Development]
#RewriteCond %{HTTP_HOST} ^staging\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production/Staging]
#RewriteCond %{HTTP_HOST} ^www\.example\.com$
#RewriteRule .? - [E=TYPO3_CONTEXT:Production]
# Rule for versioned static files, configured through:
# - $GLOBALS['TYPO3_CONF_VARS']['BE']['versionNumberInFilename']
# - $GLOBALS['TYPO3_CONF_VARS']['FE']['versionNumberInFilename']
# IMPORTANT: This rule has to be the very first RewriteCond in order to work!
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)\.(\d+)\.(php|js|mjs|css|png|jpg|gif|svg|avif|webp|gz)$ %{ENV:CWD}$1.$3 [L]
# Access block for folders
RewriteRule _(?:recycler|temp)_/ - [F]
RewriteRule fileadmin/templates/.*\.(?:txt|ts)$ - [F]
RewriteRule ^(?:vendor|typo3_src|typo3temp/var) - [F]
RewriteRule (?:typo3conf/ext|typo3/sysext|typo3/ext)/[^/]+/(?:Configuration|Resources/Private|Tests?|Documentation|docs?)/ - [F]
# Block access to all hidden files and directories with the exception of
# the visible content from within the `/.well-known/` hidden directory (RFC 5785).
RewriteCond %{REQUEST_URI} "!(^|/)\.well-known/([^./]+./?)+$" [NC]
RewriteCond %{SCRIPT_FILENAME} -d [OR]
RewriteCond %{SCRIPT_FILENAME} -f
RewriteRule (?:^|/)\. - [F]
# Redirect missing hardcoded Collateral file URLs to a resolver that
# chooses the newest available version by filename convention.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^fileadmin/downloads/Collateral/(.+)$ %{ENV:CWD}collateral-fallback.php?requested=$1 [QSA,L,NC]
# Stop rewrite processing, if we are in any known directory
# NOTE: Add your additional local storages here
RewriteRule ^(?:fileadmin/|typo3conf/|typo3temp/|uploads/) - [L]
# If the file/symlink/directory does not exist but is below /typo3/, redirect to the main TYPO3 entry point.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^typo3/(.*)$ %{ENV:CWD}index.php [QSA,L]
# --- VITEC phase B: SPA fallback (PREPARED, switch day only) ----------
# Uncomment this block to make every page URL serve the React app
# (public/_frontend/index.html). TYPO3 keeps answering JSON under
# /_json (the JsonPrefixRewrite middleware strips the prefix) plus the
# direct endpoints excluded below. Requires the front-end build with
# router basename "/" and the /_json API prefix FIRST. Roll back by
# re-commenting. See work log section 5r (2026-09-28).
# TYPO3 v14 install tool: its entry point is the SITE ROOT plus
# ?__typo3_install (install.php only redirects there, PathGuard). The
# backend's Settings/Environment/Maintenance/Upgrade modules depend on
# it - without this exception they show the React app instead.
RewriteCond %{QUERY_STRING} __typo3_install
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]
# --- VITEC SSR routing (flag-gated) -----------------------------------
# Active ONLY while the flag file below exists. Mirrors the SPA
# fallback's exclusions but PROXIES page requests to the SSR node on
# the Solr VPS instead of serving the React shell (mod_proxy incl.
# https target verified on this host 2026-11-09, see Nextcloud
# vitec-solr/ssr/README-SSR-Setup.md). The flag is written/removed by
# EXT:vitec (Site Set switch "vitec.ssr.enabled" -> SsrFlagService,
# synced by the SyncSsrFlag middleware / vitec:ssr-flag command).
# Emergency off without TYPO3: delete the flag file.
RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f
RewriteRule ^$ https://vitec-ssr.evomedien.de/ [P,L,E=SSRPROXY:1]
# mod_dir turns "/" into "/index.html" via DirectoryIndex subrequest
# before the rule above can proxy it (found 2026-11-09 evening: the
# SSR node logged GET /index.html -> /_json/index.html -> 404).
# Catch that spelling and send it to the node as the homepage:
RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f
RewriteRule ^index\.html$ https://vitec-ssr.evomedien.de/ [P,L,E=SSRPROXY:1]
# Flag ON: the hashed JS/CSS files come from the VPS release too
# (0054-FE 5.1 / 0055-BE question 1). No !-f guard on purpose: a
# same-named file from an older local SPA build must not win, the
# SSR HTML references the hashes of the VPS release.
RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f
RewriteRule ^_frontend/assets/(.*)$ https://vitec-ssr.evomedien.de/_frontend/assets/$1 [P,L,E=SSRPROXY:1]
RewriteCond /usr/www/users/vitecevo/live/var/vitec-ssr-on.flag -f
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_URI} !^/_json(/|$)
RewriteCond %{REQUEST_URI} !^/typo3(/|$)
RewriteCond %{REQUEST_URI} !^/download/
RewriteCond %{REQUEST_URI} !^/api/
RewriteCond %{REQUEST_URI} !^/_frontend/
RewriteCond %{REQUEST_URI} !^/sitemap
RewriteRule ^(.*)$ https://vitec-ssr.evomedien.de/$1 [P,L,E=SSRPROXY:1]
# The SSR node derives absolute URLs from X-Forwarded-Host/-Proto;
# mod_proxy sends -Host on its own, -Proto needs a hand (0054-FE 5.2):
RequestHeader set X-Forwarded-Proto https env=SSRPROXY
# ----------------------------------------------------------------------
# The root path needs its own rule: for "/" REQUEST_FILENAME is the
# docroot DIRECTORY, so the !-d guard below skips it and DirectoryIndex
# would hand it to TYPO3 (JSON). The homepage JSON lives at /_json/.
RewriteRule ^$ %{ENV:CWD}_frontend/index.html [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteCond %{REQUEST_URI} !^/_json(/|$)
RewriteCond %{REQUEST_URI} !^/typo3(/|$)
RewriteCond %{REQUEST_URI} !^/download/
RewriteCond %{REQUEST_URI} !^/api/
RewriteCond %{REQUEST_URI} !^/_frontend/
RewriteCond %{REQUEST_URI} !^/sitemap
RewriteRule ^.*$ %{ENV:CWD}_frontend/index.html [L]
# ----------------------------------------------------------------------
# If the file/symlink/directory does not exist => Redirect to index.php.
# For httpd.conf, you need to prefix each '%{REQUEST_FILENAME}' with '%{DOCUMENT_ROOT}'.
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]
# Access block for files
# Apache < 2.3
Order allow,deny
Deny from all
Satisfy All
# Apache ≥ 2.3
Require all denied
# Block access to vcs directories
RedirectMatch 404 /\.(?:git|svn|hg)/
### End: Rewriting and Access ###
### Begin: Miscellaneous ###
# 404 error prevention for non-existing redirected folders
Options -MultiViews
# Make sure that directory listings are disabled.
Options -Indexes
# Force IE to render pages in the highest available mode
Header set X-UA-Compatible "IE=edge"
Header unset X-UA-Compatible
# Reducing MIME type security risks
Header set X-Content-Type-Options "nosniff"
# TYPO3 cache-tag/debug headers: internal ids, and on news pages >16 KB,
# which overflowed the SSR node's default header limit (0054-FE 5.4) -
# never send them to clients.
Header unset X-TYPO3-Cache-Tags
Header unset X-TYPO3-Cache-Tags-1
Header unset X-TYPO3-Cache-Tags-2
Header unset X-TYPO3-Cache-Tags-3
Header unset X-TYPO3-Debug-Cache
Header unset X-TYPO3-Cache-Lifetime
Header unset X-TYPO3-Parsetime
# Depending on the PHP SAPI these can sit in the "always" table:
Header always unset X-TYPO3-Cache-Tags
Header always unset X-TYPO3-Cache-Tags-1
Header always unset X-TYPO3-Cache-Tags-2
Header always unset X-TYPO3-Cache-Tags-3
Header always unset X-TYPO3-Debug-Cache
Header always unset X-TYPO3-Cache-Lifetime
Header always unset X-TYPO3-Parsetime
# ETag removal - except for the /_json API: there TYPO3 (JsonCacheHeaders
# middleware) sends a content ETag so browsers can revalidate with 304
# (tickets 0011-FE / 0055-BE).
SetEnvIf Request_URI "^/_json($|/)" KEEP_ETAG=1
# After the mod_rewrite internal redirect to index.php the variable
# is renamed REDIRECT_KEEP_ETAG - carry it back over:
SetEnvIf REDIRECT_KEEP_ETAG 1 KEEP_ETAG=1
Header unset ETag env=!KEEP_ETAG
FileETag None
### End: Miscellaneous ###
# Add your own rules here.
AuthUserFile "/usr/www/users/vitecevo/live/public/.htpasswd"
AuthName "DEV"
AuthType Basic
Require ip 217.70.192.164
# The server itself (136.243.123.171 public, loopback variants): lets the
# sub-market importer download assets from dev URLs and keeps the door
# open for a future SSR process fetching /_json server-side (2026-10-02).
Require ip 136.243.123.171
Require ip 127.0.0.1
Require ip ::1
Require valid-user