···188188 <itemizedlist>
189189 <listitem>
190190 <para>
191191+ The <literal>paperless</literal> module and package have been
192192+ removed. All users should migrate to the successor
193193+ <literal>paperless-ng</literal> instead. The Paperless project
194194+ <link xlink:href="https://github.com/the-paperless-project/paperless/commit/9b0063c9731f7c5f65b1852cb8caff97f5e40ba4">has
195195+ been archived</link> and advises all users to use
196196+ <literal>paperless-ng</literal> instead.
197197+ </para>
198198+ <para>
199199+ Users can use the <literal>services.paperless-ng</literal>
200200+ module as a replacement while noting the following
201201+ incompatibilities:
202202+ </para>
203203+ <itemizedlist spacing="compact">
204204+ <listitem>
205205+ <para>
206206+ <literal>services.paperless.ocrLanguages</literal> has no
207207+ replacement. Users should migrate to
208208+ <link xlink:href="options.html#opt-services.paperless-ng.extraConfig"><literal>services.paperless-ng.extraConfig</literal></link>
209209+ instead:
210210+ </para>
211211+ </listitem>
212212+ </itemizedlist>
213213+ <programlisting language="bash">
214214+{
215215+ services.paperless-ng.extraConfig = {
216216+ # Provide languages as ISO 639-2 codes
217217+ # separated by a plus (+) sign.
218218+ # https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
219219+ PAPERLESS_OCR_LANGUAGE = "deu+eng+jpn"; # German & English & Japanse
220220+ };
221221+}
222222+</programlisting>
223223+ <itemizedlist>
224224+ <listitem>
225225+ <para>
226226+ If you previously specified
227227+ <literal>PAPERLESS_CONSUME_MAIL_*</literal> settings in
228228+ <literal>services.paperless.extraConfig</literal> you
229229+ should remove those options now. You now
230230+ <emphasis>must</emphasis> define those settings in the
231231+ admin interface of paperless-ng.
232232+ </para>
233233+ </listitem>
234234+ <listitem>
235235+ <para>
236236+ Option <literal>services.paperless.manage</literal> no
237237+ longer exists. Use the script at
238238+ <literal>${services.paperless-ng.dataDir}/paperless-ng-manage</literal>
239239+ instead. Note that this script only exists after the
240240+ <literal>paperless-ng</literal> service has been started
241241+ at least once.
242242+ </para>
243243+ </listitem>
244244+ <listitem>
245245+ <para>
246246+ After switching to the new system configuration you should
247247+ run the Django management command to reindex your
248248+ documents and optionally create a user, if you don’t have
249249+ one already.
250250+ </para>
251251+ <para>
252252+ To do so, enter the data directory (the value of
253253+ <literal>services.paperless-ng.dataDir</literal>,
254254+ <literal>/var/lib/paperless</literal> by default), switch
255255+ to the paperless user and execute the management command
256256+ like below:
257257+ </para>
258258+ <programlisting>
259259+$ cd /var/lib/paperless
260260+$ su paperless -s /bin/sh
261261+$ ./paperless-ng-manage document_index reindex
262262+# if not already done create a user account, paperless-ng requires a login
263263+$ ./paperless-ng-manage createsuperuser
264264+Username (leave blank to use 'paperless'): my-user-name
265265+Email address: me@example.com
266266+Password: **********
267267+Password (again): **********
268268+Superuser created successfully.
269269+</programlisting>
270270+ </listitem>
271271+ </itemizedlist>
272272+ </listitem>
273273+ <listitem>
274274+ <para>
191275 The <literal>staticjinja</literal> package has been upgraded
192276 from 1.0.4 to 3.0.1
193277 </para>
+47
nixos/doc/manual/release-notes/rl-2111.section.md
···58585959## Backward Incompatibilities {#sec-release-21.11-incompatibilities}
60606161+- The `paperless` module and package have been removed. All users should migrate to the
6262+ successor `paperless-ng` instead. The Paperless project [has been
6363+ archived](https://github.com/the-paperless-project/paperless/commit/9b0063c9731f7c5f65b1852cb8caff97f5e40ba4)
6464+ and advises all users to use `paperless-ng` instead.
6565+6666+ Users can use the `services.paperless-ng` module as a replacement while noting the following incompatibilities:
6767+ - `services.paperless.ocrLanguages` has no replacement. Users should migrate to [`services.paperless-ng.extraConfig`](options.html#opt-services.paperless-ng.extraConfig) instead:
6868+ ```nix
6969+ {
7070+ services.paperless-ng.extraConfig = {
7171+ # Provide languages as ISO 639-2 codes
7272+ # separated by a plus (+) sign.
7373+ # https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
7474+ PAPERLESS_OCR_LANGUAGE = "deu+eng+jpn"; # German & English & Japanse
7575+ };
7676+ }
7777+ ```
7878+7979+ - If you previously specified `PAPERLESS_CONSUME_MAIL_*` settings in
8080+ `services.paperless.extraConfig` you should remove those options now. You
8181+ now *must* define those settings in the admin interface of paperless-ng.
8282+8383+ - Option `services.paperless.manage` no longer exists.
8484+ Use the script at `${services.paperless-ng.dataDir}/paperless-ng-manage` instead.
8585+ Note that this script only exists after the `paperless-ng` service has been
8686+ started at least once.
8787+8888+ - After switching to the new system configuration you should run the Django
8989+ management command to reindex your documents and optionally create a user,
9090+ if you don't have one already.
9191+9292+ To do so, enter the data directory (the value of
9393+ `services.paperless-ng.dataDir`, `/var/lib/paperless` by default), switch
9494+ to the paperless user and execute the management command like below:
9595+ ```
9696+ $ cd /var/lib/paperless
9797+ $ su paperless -s /bin/sh
9898+ $ ./paperless-ng-manage document_index reindex
9999+ # if not already done create a user account, paperless-ng requires a login
100100+ $ ./paperless-ng-manage createsuperuser
101101+ Username (leave blank to use 'paperless'): my-user-name
102102+ Email address: me@example.com
103103+ Password: **********
104104+ Password (again): **********
105105+ Superuser created successfully.
106106+ ```
107107+61108- The `staticjinja` package has been upgraded from 1.0.4 to 3.0.1
6210963110- The `erigon` ethereum node has moved to a new database format in `2021-05-04`, and requires a full resync