paradizelost/paperless-ngx
1
0
Fork 0
mirror of https://github.com/paperless-ngx/paperless-ngx.git synced 2025-04-02 13:45:10 -05:00
Code Issues Packages Projects Releases Wiki Activity
paperless-ngx/troubleshooting/index.html

1321 lines
54 KiB
HTML
Raw Permalink Blame History

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link rel="prev" href="../faq/">
<link rel="next" href="../changelog/">
<link rel="icon" href="../assets/favicon.png">
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.50">
<title>Troubleshooting - Paperless-ngx</title>
<link rel="stylesheet" href="../assets/stylesheets/main.a40c8224.min.css">
<link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
<link rel="stylesheet" href="../assets/extra.css">
<script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
<link href="../assets/stylesheets/glightbox.min.css" rel="stylesheet"/><style>
html.glightbox-open { overflow: initial; height: 100%; }
.gslide-title { margin-top: 0px; user-select: text; }
.gslide-desc { color: #666; user-select: text; }
.gslide-image img { background: white; }
.gscrollbar-fixer { padding-right: 15px; }
.gdesc-inner { font-size: 0.75rem; }
body[data-md-color-scheme="slate"] .gdesc-inner { background: var(--md-default-bg-color);}
body[data-md-color-scheme="slate"] .gslide-title { color: var(--md-default-fg-color);}
body[data-md-color-scheme="slate"] .gslide-desc { color: var(--md-default-fg-color);}</style> <script src="../assets/javascripts/glightbox.min.js"></script></head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#troubleshooting" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href=".." title="Paperless-ngx" class="md-header__button md-logo" aria-label="Paperless-ngx" data-md-component="logo">
<img src="../assets/logo.svg" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
Paperless-ngx
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
Troubleshooting
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9zM20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12zm-9.15 3.96h2.3L12 9z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to system preference" type="radio" name="__palette" id="__palette_2">
<label class="md-header__button md-icon" title="Switch to system preference" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
</label>
</form>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://github.com/paperless-ngx/paperless-ngx" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8M97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
</div>
<div class="md-source__repository">
paperless-ngx/paperless-ngx
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href=".." class="md-tabs__link">
Home
</a>
</li>
<li class="md-tabs__item">
<a href="../setup/" class="md-tabs__link">
Setup
</a>
</li>
<li class="md-tabs__item">
<a href="../usage/" class="md-tabs__link">
Basic Usage
</a>
</li>
<li class="md-tabs__item">
<a href="../configuration/" class="md-tabs__link">
Configuration
</a>
</li>
<li class="md-tabs__item">
<a href="../administration/" class="md-tabs__link">
Administration
</a>
</li>
<li class="md-tabs__item">
<a href="../advanced_usage/" class="md-tabs__link">
Advanced Topics
</a>
</li>
<li class="md-tabs__item">
<a href="../api/" class="md-tabs__link">
REST API
</a>
</li>
<li class="md-tabs__item">
<a href="../development/" class="md-tabs__link">
Development
</a>
</li>
<li class="md-tabs__item">
<a href="../faq/" class="md-tabs__link">
FAQs
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="./" class="md-tabs__link">
Troubleshooting
</a>
</li>
<li class="md-tabs__item">
<a href="../changelog/" class="md-tabs__link">
Changelog
</a>
</li>
</ul>
</div>
</nav>
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted md-nav--integrated" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href=".." title="Paperless-ngx" class="md-nav__button md-logo" aria-label="Paperless-ngx" data-md-component="logo">
<img src="../assets/logo.svg" alt="logo">
</a>
Paperless-ngx
</label>
<div class="md-nav__source">
<a href="https://github.com/paperless-ngx/paperless-ngx" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8M97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
</div>
<div class="md-source__repository">
paperless-ngx/paperless-ngx
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href=".." class="md-nav__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../setup/" class="md-nav__link">
<span class="md-ellipsis">
Setup
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../usage/" class="md-nav__link">
<span class="md-ellipsis">
Basic Usage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../configuration/" class="md-nav__link">
<span class="md-ellipsis">
Configuration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../administration/" class="md-nav__link">
<span class="md-ellipsis">
Administration
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../advanced_usage/" class="md-nav__link">
<span class="md-ellipsis">
Advanced Topics
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../api/" class="md-nav__link">
<span class="md-ellipsis">
REST API
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../development/" class="md-nav__link">
<span class="md-ellipsis">
Development
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../faq/" class="md-nav__link">
<span class="md-ellipsis">
FAQs
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Troubleshooting
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
Troubleshooting
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#no-files-are-added-by-the-consumer" class="md-nav__link">
<span class="md-ellipsis">
No files are added by the consumer
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#consumer-warns-ocr-for-xx-failed" class="md-nav__link">
<span class="md-ellipsis">
Consumer warns OCR for XX failed
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#consumer-fails-to-pickup-any-new-files" class="md-nav__link">
<span class="md-ellipsis">
Consumer fails to pickup any new files
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#paperless-always-redirects-to-admin" class="md-nav__link">
<span class="md-ellipsis">
Paperless always redirects to /admin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#operation-not-permitted" class="md-nav__link">
<span class="md-ellipsis">
Operation not permitted
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#classifier-error-no-training-data-available" class="md-nav__link">
<span class="md-ellipsis">
Classifier error: No training data available
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#userwarning-in-sklearn-on-every-single-document" class="md-nav__link">
<span class="md-ellipsis">
UserWarning in sklearn on every single document
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#504-server-error-gateway-timeout-when-adding-office-documents" class="md-nav__link">
<span class="md-ellipsis">
504 Server Error: Gateway Timeout when adding Office documents
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#permission-denied-errors-in-the-consumption-directory" class="md-nav__link">
<span class="md-ellipsis">
Permission denied errors in the consumption directory
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#oserror-errno-19-no-such-device-when-consuming-files" class="md-nav__link">
<span class="md-ellipsis">
OSError: [Errno 19] No such device when consuming files
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#web-ui-stuck-at-loading" class="md-nav__link">
<span class="md-ellipsis">
Web-UI stuck at "Loading..."
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#error-while-reading-metadata" class="md-nav__link">
<span class="md-ellipsis">
Error while reading metadata
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#consumer-fails-with-a-filenotfounderror" class="md-nav__link">
<span class="md-ellipsis">
Consumer fails with a FileNotFoundError
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#consumer-fails-waiting-for-file-to-remain-unmodified" class="md-nav__link">
<span class="md-ellipsis">
Consumer fails waiting for file to remain unmodified.
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#consumer-fails-reporting-os-reports-file-as-busy-still" class="md-nav__link">
<span class="md-ellipsis">
Consumer fails reporting "OS reports file as busy still".
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#log-reports-creating-paperlesstask-failed" class="md-nav__link">
<span class="md-ellipsis">
Log reports "Creating PaperlessTask failed".
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#gunicorn-fails-to-start-with-is-not-a-valid-port-number" class="md-nav__link">
<span class="md-ellipsis">
gunicorn fails to start with "is not a valid port number"
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#database-warns-about-unique-constraint-documents_tag_name_uniq" class="md-nav__link">
<span class="md-ellipsis">
Database Warns about unique constraint "documents_tag_name_uniq
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#consumption-fails-with-ghostscript-pdfa-rendering-failed" class="md-nav__link">
<span class="md-ellipsis">
Consumption fails with "Ghostscript PDF/A rendering failed"
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#convert-uuid-field" class="md-nav__link">
<span class="md-ellipsis">
Logs show "possible incompatible database column" when deleting documents
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#platform-specific-deployment-troubleshooting" class="md-nav__link">
<span class="md-ellipsis">
Platform-Specific Deployment Troubleshooting
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../changelog/" class="md-nav__link">
<span class="md-ellipsis">
Changelog
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="troubleshooting">Troubleshooting</h1>
<h2 id="no-files-are-added-by-the-consumer">No files are added by the consumer</h2>
<p>Check for the following issues:</p>
<ul>
<li>
<p>Ensure that the directory you're putting your documents in is the
folder paperless is watching. With docker, this setting is performed
in the <code>docker-compose.yml</code> file. Without Docker, look at the
<code>CONSUMPTION_DIR</code> setting. Don't adjust this setting if you're
using docker.</p>
</li>
<li>
<p>Ensure that redis is up and running. Paperless does its task
processing asynchronously, and for documents to arrive at the task
processor, it needs redis to run.</p>
</li>
<li>
<p>Ensure that the task processor is running. Docker does this
automatically. Manually invoke the task processor by executing</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="go">celery --app paperless worker</span>
</code></pre></div>
</li>
<li>
<p>Look at the output of paperless and inspect it for any errors.</p>
</li>
<li>
<p>Go to the admin interface, and check if there are failed tasks. If
so, the tasks will contain an error message.</p>
</li>
</ul>
<h2 id="consumer-warns-ocr-for-xx-failed">Consumer warns <code>OCR for XX failed</code></h2>
<p>If you find the OCR accuracy to be too low, and/or the document consumer
warns that
<code>OCR for XX failed, but we're going to stick with what we've got since FORGIVING_OCR is enabled</code>,
then you might need to install the <a href="https://packages.ubuntu.com/search?keywords=tesseract-ocr">Tesseract language
files</a>
marching your document's languages.</p>
<p>As an example, if you are running Paperless-ngx from any Ubuntu or
Debian box, and your documents are written in Spanish you may need to
run:</p>
<div class="highlight"><pre><span></span><code>apt-get install -y tesseract-ocr-spa
</code></pre></div>
<h2 id="consumer-fails-to-pickup-any-new-files">Consumer fails to pickup any new files</h2>
<p>If you notice that the consumer will only pickup files in the
consumption directory at startup, but won't find any other files added
later, you will need to enable filesystem polling with the configuration
option <a href="../configuration/#PAPERLESS_CONSUMER_POLLING"><code>PAPERLESS_CONSUMER_POLLING</code></a>.</p>
<p>This will disable listening to filesystem changes with inotify and
paperless will manually check the consumption directory for changes
instead.</p>
<h2 id="paperless-always-redirects-to-admin">Paperless always redirects to /admin</h2>
<p>You probably had the old paperless installed at some point. Paperless
installed a permanent redirect to /admin in your browser, and you need
to clear your browsing data / cache to fix that.</p>
<h2 id="operation-not-permitted">Operation not permitted</h2>
<p>You might see errors such as:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="go">chown: changing ownership of &#39;../export&#39;: Operation not permitted</span>
</code></pre></div>
<p>The container tries to set file ownership on the listed directories.
This is required so that the user running paperless inside docker has
write permissions to these folders. This happens when pointing these
directories to NFS shares, for example.</p>
<p>Ensure that <code>chown</code> is possible on these directories.</p>
<h2 id="classifier-error-no-training-data-available">Classifier error: No training data available</h2>
<p>This indicates that the Auto matching algorithm found no documents to
learn from. This may have two reasons:</p>
<ul>
<li>You don't use the Auto matching algorithm: The error can be safely
ignored in this case.</li>
<li>You are using the Auto matching algorithm: The classifier explicitly
excludes documents with Inbox tags. Verify that there are documents
in your archive without inbox tags. The algorithm will only learn
from documents not in your inbox.</li>
</ul>
<h2 id="userwarning-in-sklearn-on-every-single-document">UserWarning in sklearn on every single document</h2>
<p>You may encounter warnings like this:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>/usr/local/lib/python3.7/site-packages/sklearn/base.py:315:
<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>UserWarning: Trying to unpickle estimator CountVectorizer from version 0.23.2 when using version 0.24.0.
<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>This might lead to breaking code or invalid results. Use at your own risk.
</code></pre></div>
<p>This happens when certain dependencies of paperless that are responsible
for the auto matching algorithm are updated. After updating these, your
current training data <em>might</em> not be compatible anymore. This can be
ignored in most cases. This warning will disappear automatically when
paperless updates the training data.</p>
<p>If you want to get rid of the warning or actually experience issues with
automatic matching, delete the file <code>classification_model.pickle</code> in the
data directory and let paperless recreate it.</p>
<h2 id="504-server-error-gateway-timeout-when-adding-office-documents">504 Server Error: Gateway Timeout when adding Office documents</h2>
<p>You may experience these errors when using the optional TIKA
integration:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a>requests.exceptions.HTTPError: 504 Server Error: Gateway Timeout for url: http://gotenberg:3000/forms/libreoffice/convert
</code></pre></div>
<p>Gotenberg is a server that converts Office documents into PDF documents
and has a default timeout of 30 seconds. When conversion takes longer,
Gotenberg raises this error.</p>
<p>You can increase the timeout by configuring a command flag for Gotenberg
(see also <a href="https://gotenberg.dev/docs/modules/api#properties">here</a>). If
using Docker Compose, this is achieved by the following configuration
change in the <code>docker-compose.yml</code> file:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="c1"># The gotenberg chromium route is used to convert .eml files. We do not</span>
<a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="c1"># want to allow external content like tracking pixels or even javascript.</span>
<a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nt">command</span><span class="p">:</span>
<a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;gotenberg&#39;</span>
<a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;--chromium-disable-javascript=true&#39;</span>
<a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;--chromium-allow-list=file:///tmp/.*&#39;</span>
<a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="s">&#39;--api-timeout=60&#39;</span>
</code></pre></div>
<h2 id="permission-denied-errors-in-the-consumption-directory">Permission denied errors in the consumption directory</h2>
<p>You might encounter errors such as:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="go">The following error occurred while consuming document.pdf: [Errno 13] Permission denied: &#39;/usr/src/paperless/src/../consume/document.pdf&#39;</span>
</code></pre></div>
<p>This happens when paperless does not have permission to delete files
inside the consumption directory. Ensure that <code>USERMAP_UID</code> and
<code>USERMAP_GID</code> are set to the user id and group id you use on the host
operating system, if these are different from <code>1000</code>. See <a href="../setup/#docker">Docker setup</a>.</p>
<p>Also ensure that you are able to read and write to the consumption
directory on the host.</p>
<h2 id="oserror-errno-19-no-such-device-when-consuming-files">OSError: [Errno 19] No such device when consuming files</h2>
<p>If you experience errors such as:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="go">File &quot;/usr/local/lib/python3.7/site-packages/whoosh/codec/base.py&quot;, line 570, in open_compound_file</span>
<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="go">return CompoundStorage(dbfile, use_mmap=storage.supports_mmap)</span>
<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="go">File &quot;/usr/local/lib/python3.7/site-packages/whoosh/filedb/compound.py&quot;, line 75, in __init__</span>
<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="go">self._source = mmap.mmap(fileno, 0, access=mmap.ACCESS_READ)</span>
<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="go">OSError: [Errno 19] No such device</span>
<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a>
<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="go">During handling of the above exception, another exception occurred:</span>
<a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a>
<a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="go">Traceback (most recent call last):</span>
<a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="go">File &quot;/usr/local/lib/python3.7/site-packages/django_q/cluster.py&quot;, line 436, in worker</span>
<a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="go">res = f(*task[&quot;args&quot;], **task[&quot;kwargs&quot;])</span>
<a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="go">File &quot;/usr/src/paperless/src/documents/tasks.py&quot;, line 73, in consume_file</span>
<a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a><span class="go">override_tag_ids=override_tag_ids)</span>
<a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="go">File &quot;/usr/src/paperless/src/documents/consumer.py&quot;, line 271, in try_consume_file</span>
<a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="go">raise ConsumerError(e)</span>
</code></pre></div>
<p>Paperless uses a search index to provide better and faster full text
searching. This search index is stored inside the <code>data</code> folder. The
search index uses memory-mapped files (mmap). The above error indicates
that paperless was unable to create and open these files.</p>
<p>This happens when you're trying to store the data directory on certain
file systems (mostly network shares) that don't support memory-mapped
files.</p>
<h2 id="web-ui-stuck-at-loading">Web-UI stuck at "Loading..."</h2>
<p>This might have multiple reasons.</p>
<ol>
<li>
<p>If you built the docker image yourself or deployed using the bare
metal route, make sure that there are files in
<code>&lt;paperless-root&gt;/static/frontend/&lt;lang-code&gt;/</code>. If there are no
files, make sure that you executed <code>collectstatic</code> successfully,
either manually or as part of the docker image build.</p>
<p>If the front end is still missing, make sure that the front end is
compiled (files present in <code>src/documents/static/frontend</code>). If it
is not, you need to compile the front end yourself or download the
release archive instead of cloning the repository.</p>
</li>
<li>
<p>Check the output of the web server. You might see errors like this:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>[2021-01-25 10:08:04 +0000] [40] [ERROR] Socket error processing request.
<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>Traceback (most recent call last):
<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>File &quot;/usr/local/lib/python3.7/site-packages/gunicorn/workers/sync.py&quot;, line 134, in handle
<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a> self.handle_request(listener, req, client, addr)
<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a>File &quot;/usr/local/lib/python3.7/site-packages/gunicorn/workers/sync.py&quot;, line 190, in handle_request
<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a> util.reraise(*sys.exc_info())
<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>File &quot;/usr/local/lib/python3.7/site-packages/gunicorn/util.py&quot;, line 625, in reraise
<a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a> raise value
<a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a>File &quot;/usr/local/lib/python3.7/site-packages/gunicorn/workers/sync.py&quot;, line 178, in handle_request
<a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a> resp.write_file(respiter)
<a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a>File &quot;/usr/local/lib/python3.7/site-packages/gunicorn/http/wsgi.py&quot;, line 396, in write_file
<a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a> if not self.sendfile(respiter):
<a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a>File &quot;/usr/local/lib/python3.7/site-packages/gunicorn/http/wsgi.py&quot;, line 386, in sendfile
<a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a> sent += os.sendfile(sockno, fileno, offset + sent, count)
<a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a>OSError: [Errno 22] Invalid argument
</code></pre></div>
<p>To fix this issue, add</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a>SENDFILE=0
</code></pre></div>
<p>to your <code>docker-compose.env</code> file.</p>
</li>
</ol>
<h2 id="error-while-reading-metadata">Error while reading metadata</h2>
<p>You might find messages like these in your log files:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a>[WARNING] [paperless.parsing.tesseract] Error while reading metadata
</code></pre></div>
<p>This indicates that paperless failed to read PDF metadata from one of
your documents. This happens when you open the affected documents in
paperless for editing. Paperless will continue to work, and will simply
not show the invalid metadata.</p>
<h2 id="consumer-fails-with-a-filenotfounderror">Consumer fails with a FileNotFoundError</h2>
<p>You might find messages like these in your log files:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a>[ERROR] [paperless.consumer] Error while consuming document SCN_0001.pdf: FileNotFoundError: [Errno 2] No such file or directory: &#39;/tmp/ocrmypdf.io.yhk3zbv0/origin.pdf&#39;
<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>Traceback (most recent call last):
<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a> File &quot;/app/paperless/src/paperless_tesseract/parsers.py&quot;, line 261, in parse
<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a> ocrmypdf.ocr(**args)
<a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a> File &quot;/usr/local/lib/python3.8/dist-packages/ocrmypdf/api.py&quot;, line 337, in ocr
<a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a> return run_pipeline(options=options, plugin_manager=plugin_manager, api=True)
<a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a> File &quot;/usr/local/lib/python3.8/dist-packages/ocrmypdf/_sync.py&quot;, line 385, in run_pipeline
<a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a> exec_concurrent(context, executor)
<a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a> File &quot;/usr/local/lib/python3.8/dist-packages/ocrmypdf/_sync.py&quot;, line 302, in exec_concurrent
<a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a> pdf = post_process(pdf, context, executor)
<a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a> File &quot;/usr/local/lib/python3.8/dist-packages/ocrmypdf/_sync.py&quot;, line 235, in post_process
<a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a> pdf_out = metadata_fixup(pdf_out, context)
<a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a> File &quot;/usr/local/lib/python3.8/dist-packages/ocrmypdf/_pipeline.py&quot;, line 798, in metadata_fixup
<a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a> with pikepdf.open(context.origin) as original, pikepdf.open(working_file) as pdf:
<a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a> File &quot;/usr/local/lib/python3.8/dist-packages/pikepdf/_methods.py&quot;, line 923, in open
<a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a> pdf = Pdf._open(
<a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a>FileNotFoundError: [Errno 2] No such file or directory: &#39;/tmp/ocrmypdf.io.yhk3zbv0/origin.pdf&#39;
</code></pre></div>
<p>This probably indicates paperless tried to consume the same file twice.
This can happen for a number of reasons, depending on how documents are
placed into the consume folder. If paperless is using inotify (the
default) to check for documents, try adjusting the
<a href="../configuration/#inotify">inotify configuration</a>. If polling is enabled, try adjusting the
<a href="../configuration/#polling">polling configuration</a>.</p>
<h2 id="consumer-fails-waiting-for-file-to-remain-unmodified">Consumer fails waiting for file to remain unmodified.</h2>
<p>You might find messages like these in your log files:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a>[ERROR] [paperless.management.consumer] Timeout while waiting on file /usr/src/paperless/src/../consume/SCN_0001.pdf to remain unmodified.
</code></pre></div>
<p>This indicates paperless timed out while waiting for the file to be
completely written to the consume folder. Adjusting
<a href="../configuration/#polling">polling configuration</a> values should resolve the issue.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The user will need to manually move the file out of the consume folder
and back in, for the initial failing file to be consumed.</p>
</div>
<h2 id="consumer-fails-reporting-os-reports-file-as-busy-still">Consumer fails reporting "OS reports file as busy still".</h2>
<p>You might find messages like these in your log files:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a>[WARNING] [paperless.management.consumer] Not consuming file /usr/src/paperless/src/../consume/SCN_0001.pdf: OS reports file as busy still
</code></pre></div>
<p>This indicates paperless was unable to open the file, as the OS reported
the file as still being in use. To prevent a crash, paperless did not
try to consume the file. If paperless is using inotify (the default) to
check for documents, try adjusting the
<a href="../configuration/#inotify">inotify configuration</a>. If polling is enabled, try adjusting the
<a href="../configuration/#polling">polling configuration</a>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The user will need to manually move the file out of the consume folder
and back in, for the initial failing file to be consumed.</p>
</div>
<h2 id="log-reports-creating-paperlesstask-failed">Log reports "Creating PaperlessTask failed".</h2>
<p>You might find messages like these in your log files:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a>[ERROR] [paperless.management.consumer] Creating PaperlessTask failed: db locked
</code></pre></div>
<p>You are likely using an sqlite based installation, with an increased
number of workers and are running into sqlite's concurrency
limitations. Uploading or consuming multiple files at once results in
many workers attempting to access the database simultaneously.</p>
<p>Consider changing to the PostgreSQL database if you will be processing
many documents at once often. Otherwise, try tweaking the
<a href="../configuration/#PAPERLESS_DB_TIMEOUT"><code>PAPERLESS_DB_TIMEOUT</code></a> setting to allow more time for the database to
unlock. Additionally, you can change your SQLite database to use <a href="https://sqlite.org/wal.html">"Write-Ahead Logging"</a>.
These changes may have minor performance implications but can help
prevent database locking issues.</p>
<h2 id="gunicorn-fails-to-start-with-is-not-a-valid-port-number">gunicorn fails to start with "is not a valid port number"</h2>
<p>You are likely running using Kubernetes, which automatically creates an
environment variable named <code>${serviceName}_PORT</code>. This is
the same environment variable which is used by Paperless to optionally
change the port gunicorn listens on.</p>
<p>To fix this, set <a href="../configuration/#PAPERLESS_PORT"><code>PAPERLESS_PORT</code></a> again to your desired port, or the
default of 8000.</p>
<h2 id="database-warns-about-unique-constraint-documents_tag_name_uniq">Database Warns about unique constraint "documents_tag_name_uniq</h2>
<p>You may see database log lines like:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a>ERROR: duplicate key value violates unique constraint &quot;documents_tag_name_uniq&quot;
<a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a>DETAIL: Key (name)=(NameF) already exists.
<a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a>STATEMENT: INSERT INTO &quot;documents_tag&quot; (&quot;owner_id&quot;, &quot;name&quot;, &quot;match&quot;, &quot;matching_algorithm&quot;, &quot;is_insensitive&quot;, &quot;color&quot;, &quot;is_inbox_tag&quot;) VALUES (NULL, &#39;NameF&#39;, &#39;&#39;, 1, true, &#39;#a6cee3&#39;, false) RETURNING &quot;documents_tag&quot;.&quot;id&quot;
</code></pre></div>
<p>This can happen during heavy consumption when using polling. Paperless will handle it correctly and the file
will still be consumed</p>
<h2 id="consumption-fails-with-ghostscript-pdfa-rendering-failed">Consumption fails with "Ghostscript PDF/A rendering failed"</h2>
<p>Newer versions of OCRmyPDF will fail if it encounters errors during processing.
This is intentional as the output archive file may differ in unexpected or undesired
ways from the original. As the logs indicate, if you encounter this error you can set
<code>PAPERLESS_OCR_USER_ARGS: '{"continue_on_soft_render_error": true}'</code> to try to 'force'
processing documents with this issue.</p>
<h2 id="convert-uuid-field">Logs show "possible incompatible database column" when deleting documents</h2>
<p>You may see errors when deleting documents like:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a>Data too long for column &#39;transaction_id&#39; at row 1
</code></pre></div>
<p>This error can occur in installations which have upgraded from a version of Paperless-ngx that used Django 4 (Paperless-ngx versions prior to v2.13.0) with a MariaDB/MySQL database. Due to the backawards-incompatible change in Django 5, the column "documents_document.transaction_id" will need to be re-created, which can be done with a one-time run of the following management command:</p>
<div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="gp">$ </span>python3<span class="w"> </span>manage.py<span class="w"> </span>convert_mariadb_uuid
</code></pre></div>
<h2 id="platform-specific-deployment-troubleshooting">Platform-Specific Deployment Troubleshooting</h2>
<p>A user-maintained wiki page is available to help troubleshoot issues that may arise when trying to deploy Paperless-ngx on specific platforms, for example SELinux. Please see <a href="https://github.com/paperless-ngx/paperless-ngx/wiki/Platform%E2%80%90Specific-Troubleshooting">the wiki</a>.</p>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
Back to top
</button>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Copyright &copy; 2016 - 2023 Daniel Quinn, Jonas Winkler, and the Paperless-ngx team
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
<div class="md-social">
<a href="https://github.com/paperless-ngx/paperless-ngx" target="_blank" rel="noopener" title="github.com" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512"><!--! Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8M97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
</a>
<a href="https://hub.docker.com/r/paperlessngx/paperless-ngx" target="_blank" rel="noopener" title="hub.docker.com" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512"><!--! Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M349.9 236.3h-66.1v-59.4h66.1zm0-204.3h-66.1v60.7h66.1zm78.2 144.8H362v59.4h66.1zm-156.3-72.1h-66.1v60.1h66.1zm78.1 0h-66.1v60.1h66.1zm276.8 100c-14.4-9.7-47.6-13.2-73.1-8.4-3.3-24-16.7-44.9-41.1-63.7l-14-9.3-9.3 14c-18.4 27.8-23.4 73.6-3.7 103.8-8.7 4.7-25.8 11.1-48.4 10.7H2.4c-8.7 50.8 5.8 116.8 44 162.1 37.1 43.9 92.7 66.2 165.4 66.2 157.4 0 273.9-72.5 328.4-204.2 21.4.4 67.6.1 91.3-45.2 1.5-2.5 6.6-13.2 8.5-17.1zm-511.1-27.9h-66v59.4h66.1v-59.4zm78.1 0h-66.1v59.4h66.1zm78.1 0h-66.1v59.4h66.1zm-78.1-72.1h-66.1v60.1h66.1z"/></svg>
</a>
<a href="https://matrix.to/#/#paperless:matrix.org" target="_blank" rel="noopener" title="matrix.to" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 3c5.5 0 10 3.58 10 8s-4.5 8-10 8c-1.24 0-2.43-.18-3.53-.5C5.55 21 2 21 2 21c2.33-2.33 2.7-3.9 2.75-4.5C3.05 15.07 2 13.13 2 11c0-4.42 4.5-8 10-8"/></svg>
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.top", "toc.integrate", "content.code.annotate"], "search": "../assets/javascripts/workers/search.f8cc74c7.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../assets/javascripts/bundle.60a45f97.min.js"></script>
<script id="init-glightbox">const lightbox = GLightbox({"touchNavigation": true, "loop": false, "zoomable": true, "draggable": true, "openEffect": "zoom", "closeEffect": "zoom", "slideEffect": "slide"});
document$.subscribe(() => { lightbox.reload() });
</script></body>
</html>
Reference in New Issue View Git Blame Copy Permalink