···188 <itemizedlist>
189 <listitem>
190 <para>
000000000000000000000000000000000000000000000000000000000000000000000000000000000000191 The <literal>staticjinja</literal> package has been upgraded
192 from 1.0.4 to 3.0.1
193 </para>
···188 <itemizedlist>
189 <listitem>
190 <para>
191+ The <literal>paperless</literal> module and package have been
192+ removed. All users should migrate to the successor
193+ <literal>paperless-ng</literal> instead. The Paperless project
194+ <link xlink:href="https://github.com/the-paperless-project/paperless/commit/9b0063c9731f7c5f65b1852cb8caff97f5e40ba4">has
195+ been archived</link> and advises all users to use
196+ <literal>paperless-ng</literal> instead.
197+ </para>
198+ <para>
199+ Users can use the <literal>services.paperless-ng</literal>
200+ module as a replacement while noting the following
201+ incompatibilities:
202+ </para>
203+ <itemizedlist spacing="compact">
204+ <listitem>
205+ <para>
206+ <literal>services.paperless.ocrLanguages</literal> has no
207+ replacement. Users should migrate to
208+ <link xlink:href="options.html#opt-services.paperless-ng.extraConfig"><literal>services.paperless-ng.extraConfig</literal></link>
209+ instead:
210+ </para>
211+ </listitem>
212+ </itemizedlist>
213+ <programlisting language="bash">
214+{
215+ services.paperless-ng.extraConfig = {
216+ # Provide languages as ISO 639-2 codes
217+ # separated by a plus (+) sign.
218+ # https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
219+ PAPERLESS_OCR_LANGUAGE = "deu+eng+jpn"; # German & English & Japanse
220+ };
221+}
222+</programlisting>
223+ <itemizedlist>
224+ <listitem>
225+ <para>
226+ If you previously specified
227+ <literal>PAPERLESS_CONSUME_MAIL_*</literal> settings in
228+ <literal>services.paperless.extraConfig</literal> you
229+ should remove those options now. You now
230+ <emphasis>must</emphasis> define those settings in the
231+ admin interface of paperless-ng.
232+ </para>
233+ </listitem>
234+ <listitem>
235+ <para>
236+ Option <literal>services.paperless.manage</literal> no
237+ longer exists. Use the script at
238+ <literal>${services.paperless-ng.dataDir}/paperless-ng-manage</literal>
239+ instead. Note that this script only exists after the
240+ <literal>paperless-ng</literal> service has been started
241+ at least once.
242+ </para>
243+ </listitem>
244+ <listitem>
245+ <para>
246+ After switching to the new system configuration you should
247+ run the Django management command to reindex your
248+ documents and optionally create a user, if you don’t have
249+ one already.
250+ </para>
251+ <para>
252+ To do so, enter the data directory (the value of
253+ <literal>services.paperless-ng.dataDir</literal>,
254+ <literal>/var/lib/paperless</literal> by default), switch
255+ to the paperless user and execute the management command
256+ like below:
257+ </para>
258+ <programlisting>
259+$ cd /var/lib/paperless
260+$ su paperless -s /bin/sh
261+$ ./paperless-ng-manage document_index reindex
262+# if not already done create a user account, paperless-ng requires a login
263+$ ./paperless-ng-manage createsuperuser
264+Username (leave blank to use 'paperless'): my-user-name
265+Email address: me@example.com
266+Password: **********
267+Password (again): **********
268+Superuser created successfully.
269+</programlisting>
270+ </listitem>
271+ </itemizedlist>
272+ </listitem>
273+ <listitem>
274+ <para>
275 The <literal>staticjinja</literal> package has been upgraded
276 from 1.0.4 to 3.0.1
277 </para>
+47
nixos/doc/manual/release-notes/rl-2111.section.md
···5859## Backward Incompatibilities {#sec-release-21.11-incompatibilities}
600000000000000000000000000000000000000000000000061- The `staticjinja` package has been upgraded from 1.0.4 to 3.0.1
6263- The `erigon` ethereum node has moved to a new database format in `2021-05-04`, and requires a full resync
···5859## Backward Incompatibilities {#sec-release-21.11-incompatibilities}
6061+- The `paperless` module and package have been removed. All users should migrate to the
62+ successor `paperless-ng` instead. The Paperless project [has been
63+ archived](https://github.com/the-paperless-project/paperless/commit/9b0063c9731f7c5f65b1852cb8caff97f5e40ba4)
64+ and advises all users to use `paperless-ng` instead.
65+66+ Users can use the `services.paperless-ng` module as a replacement while noting the following incompatibilities:
67+ - `services.paperless.ocrLanguages` has no replacement. Users should migrate to [`services.paperless-ng.extraConfig`](options.html#opt-services.paperless-ng.extraConfig) instead:
68+ ```nix
69+ {
70+ services.paperless-ng.extraConfig = {
71+ # Provide languages as ISO 639-2 codes
72+ # separated by a plus (+) sign.
73+ # https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
74+ PAPERLESS_OCR_LANGUAGE = "deu+eng+jpn"; # German & English & Japanse
75+ };
76+ }
77+ ```
78+79+ - If you previously specified `PAPERLESS_CONSUME_MAIL_*` settings in
80+ `services.paperless.extraConfig` you should remove those options now. You
81+ now *must* define those settings in the admin interface of paperless-ng.
82+83+ - Option `services.paperless.manage` no longer exists.
84+ Use the script at `${services.paperless-ng.dataDir}/paperless-ng-manage` instead.
85+ Note that this script only exists after the `paperless-ng` service has been
86+ started at least once.
87+88+ - After switching to the new system configuration you should run the Django
89+ management command to reindex your documents and optionally create a user,
90+ if you don't have one already.
91+92+ To do so, enter the data directory (the value of
93+ `services.paperless-ng.dataDir`, `/var/lib/paperless` by default), switch
94+ to the paperless user and execute the management command like below:
95+ ```
96+ $ cd /var/lib/paperless
97+ $ su paperless -s /bin/sh
98+ $ ./paperless-ng-manage document_index reindex
99+ # if not already done create a user account, paperless-ng requires a login
100+ $ ./paperless-ng-manage createsuperuser
101+ Username (leave blank to use 'paperless'): my-user-name
102+ Email address: me@example.com
103+ Password: **********
104+ Password (again): **********
105+ Superuser created successfully.
106+ ```
107+108- The `staticjinja` package has been upgraded from 1.0.4 to 3.0.1
109110- The `erigon` ethereum node has moved to a new database format in `2021-05-04`, and requires a full resync