MIME configuration

Which file types you can upload via the media manager popup or the fullscreen media manager is configured through the conf/mime.conf file. It also configures the file extension ↔ mimetype association.

For security reasons it is not possible to configure DokuWiki to allow any file type.

Never enable HTML upload for unprotected wikis, as this opens Cross Site Scripting vulnerabilities through JavaScript. Only enable this with trusted users. You need to disable the iexssprotect option additionally to adding the HTML mime type in the config file.

You can find any file extension with its mime at https://filext.com/, these are used since the Igor 2022 release.

For Hogfather 2020 release and older, the icons were created with the file icon generator. Old additional icons in the old style are available at https://www.splitbrain.org/projects/file_icons

Adding additional Mime Types

Additional mimetypes should be added in mime.local.conf (you need to create this file). The file expects an extension (without the dot) and a mime type. Prefixing the mime type with an exclamation mark (!) will force the browser to present a download dialog, even if a browser plugin for the file in question exists.

Example:

conf/mime.local.conf

# this would play in the browser (if supported):
wav         audio/wav

# this would be downloaded
wav         !audio/wav

Disable by mention the extension without a mimetype. Disabling png-images by:

conf/mime.local.conf

png

For configuration changes to take effect on the pages, the cache must be purged.

File type icons

File type icons can be added by placing an image SVG file named after the file extension into lib/images/fileicons/svg/. Note: because the stylesheet used for assigning the fileicons gets cached you need to force a rebuild by touching one of the config files or just save the Configuration Manager another time.

Since Igor 2022 release only SVG icons are automatically recognized. See also this forum post about a workaround .

From Hogfather 2020 and older only PNG¹⁾ or GIF²⁾ are automatically recognized in the folder lib/images/fileicons/.

Default Mime Types

The default install contains the following configurations:

Extension	Mime type	Icon
jpg	image/jpeg
jpeg	image/jpeg
gif	image/gif
png	image/png
webp	image/webp
ico	image/vnd.microsoft.icon
svg	image/svg+xml
mp3	audio/mpeg
ogg	audio/ogg
wav	audio/wav
webm	video/webm
ogv	video/ogg
mp4	video/mp4
vtt	text/vtt
tgz	!application/octet-stream
tar	!application/x-gtar
gz	!application/octet-stream
bz2	!application/octet-stream
zip	!application/zip
rar	!application/rar
7z	!application/x-7z-compressed
pdf	application/pdf
ps	!application/postscript
rpm	!application/octet-stream
deb	!application/octet-stream
doc	!application/msword
xls	!application/msexcel
ppt	!application/mspowerpoint
rtf	!application/msword
docx	!application/vnd.openxmlformats-officedocument.wordprocessingml.document
xlsx	!application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
pptx	!application/vnd.openxmlformats-officedocument.presentationml.presentation
sxw	!application/soffice
sxc	!application/soffice
sxi	!application/soffice
sxd	!application/soffice
odc	!application/vnd.oasis.opendocument.chart
odf	!application/vnd.oasis.opendocument.formula
odg	!application/vnd.oasis.opendocument.graphics
odi	!application/vnd.oasis.opendocument.image
odp	!application/vnd.oasis.opendocument.presentation
ods	!application/vnd.oasis.opendocument.spreadsheet
odt	!application/vnd.oasis.opendocument.text