Changelog History
Page 2
-
v0.29.0 Changes
Nov 18, 2021
- 👷 Show number of waiting jobs in the top bar (#1069). This introduces some changes under the hood, for example: while previously the restserver was notifying job executors about new jobs, it will now also receive messages from the job executors. This requires a new setting (see below).
- 0️⃣ Hide sidebar by default on mobile (#1169)
- 👌 Improve scanmailbox form (#1147)
- 👌 Improve input of an e-mail address (#987)
- 🛠 Fix e-mail import for certain files (#1140)
- 🛠 FIx uploading files with non-ascii filenames (#991)
Rest API Changes
None
🔧 Configuration Changes
Important
- the restserver has a new setting
internal-url
which must be set to the base url of the server such that other nodes (i.e. joex nodes) can reach it. It is by default set tohttp://localhost:7880
. If you are using docker: thedocker-compose.yml
in this repository has been updated. You can copy&paste the new env variableDOCSPELL_SERVER_INTERNAL__URL=http://docspell-restserver:7880
into yourdocker-compose.yml
or add it to your config file.
-
v0.28.0 Changes
Oct 27, 2021
- Share items (#446). Allows to create shares, public cryptic links, to a subset of your documents that can be shared with other people (who don't need an account). It is possible to search inside the shared subset. Shares have a lifetime and can be password protected.
- 👌 Support encrypted PDFs (#1074). When importing PDF files, the protection layer (usually for signed PDFs) is being removed in order to process it. The config file and collective settings can now define a list of passwords that are being used when trying to decrypt encrypted PDFs.
- 🔧 Use environment variables to configure Docspell instead of a config file (#1121). This is mainly intended when running via docker or other similar tools. Note that settings that accept list as its values are not yet supported.
- 💻 Try to detect the best way to render PDFs (#1099). Mobile browsers need a fallback for rendering PDFs, but desktop browsers can do it much better natively. The user settings allow to decide how to render a PDF or to let docspell detect it.
- Filter possible values in search menu based on current results (#856). This removes options that would only yield empty results from the dropdowns.
- 🛠 Fix search in documenation (#1120)
Rest API Changes
/share/*
routes to access a share/open/share/verify
routes to verify a share id/sec/share/*
routes to manage shares- extend
SearchStats
to include correspondents/concerning numbers
🔧 Configuration Changes
- restserver: changed the server secret from the (dummy) value
hex:caffee
to an empty string. This results in a random secret generated at application start. It is recommended to set it to some random value, otherwise sessions don't survive server restarts. - joex: adds a section
decrypt-pdf
for specifying a list of passwords to try when encountering encrypted PDFs
-
v0.27.0 Changes
Sep 23, 2021
- 👍 Allow external authentication providers via OpenID Connect. Now you can integrate Docspell into your SSO solution. Using keycloak, for example (or other such tools) users can be maintained elsewhere, like in an LDAP directory. (#489)
- ➕ Adds two-factor authentication using TOTPs. If you don't want to setup an external authentication provider (which is another tool to maintain), you can use the builtin TOTP support to have two-factor authentication. (#762)
- 👌 Improvements when querying documents (#1040)
- 🔄 Changed the underlying code for storing and loading files. This is a preparation to allow different storage backends for files in the future (maybe the filesystem or s3). (#1080)
- The license has changed from GPLv3+ to AGPLv3+ (#1078)
- 🛠 Fixes a bug in the "check for updates" task that was added in the last release (#1068)
- ⬇️ Reduces the length of the startup command, which makes tools like
ps
much more readable and allows now to start docspell on Windows (untested, though ;-)) (#1062) - 🛠 Fixes merging items, where sent mails were not copied to the target item. (#1055)
- 🛠 Fixes and improves deleting users. Now all their data is also removed and it is shown what that would be. (#1060)
Rest API Changes
- The
login
routes now won't return a session token when 2FA is enabled for an account. The returned token must be used to provide the TOTP in order to finalize login. - ➕ Added
open/auth/two-factor
endpoint to provide the TOTP for login - ➕ Added
open/auth/openid/{providerId}[/resume]
endpoints to initiate authentication via an external provider - ➕ Added
sec/user/{username}/deleteData
to retrieve a summary of data that would be deleted with that user - ➕ Added
sec/user/otp/*
endpoints to manage the TOTP for an account - ➕ Added
admin/user/otp/reserOTP
to reset the 2FA setup for any user
🔧 Configuration Changes
- 🔧 Restserver: Added a section to configure external authentication provider
-
v0.26.0 Changes
Aug 28, 2021
- ➕ Add ability to merge items (#414). You can now select multiple items and merge them all into one. The first item in the list is the target item, all others are deleted after a successful merge. The webapp allows to reorder this list, of course.
- ➕ Add option to only import attachments of e-mails (#983).
- Improve Manage Data page by sorting the tables (#965, #538)
- 👍 Allow wildcard searches in queries using
attach.id
(#971). Before you would have to specify the complete id. This is inconvenient when using from the command line client. - ➕ Add Hebrew to the document languages (#1027, thans @wallace11). Please note, that the SOLR support is very basic for this language.
- ➕ Add a periodic task to check for Docspell updates (#990). Let's you check periodically for new versions of docspell. It uses an existing user account and its mail settings to send an e-mail.
- 👉 Show the link to an item and its attachments as a QR code in item details (#836). This might be useful when you want to attach this link to physical devices.
- The search menu highlights the sections that contain active filters (#966)
- Safe deletion of items (#347). When deleting items, they are now marked as deleted and can therefore be restored. A periodic job will really delete them from the database eventually.
- 👌 Improves German translation (#985, thanks @monnypython)
- 📄 The dsc tool has also been improved, thanks to @seijikun.
- ⬆️ Upgrade the website to work with newer zola versions (#847)
- ✂ Remove the scripts in
tools/
since these are now obsolete. The new command line interface covers these features now. Note that the docker images are also NOT built anymore. The directory still exits and is still a place for scripts and little tooling around docspell. - 🛠 Fixes a regression where the browser would not display the pdf (#975)
- 🛠 Fixes the health checks in the docker setup (#976)
- 🛠 Fixes an issue with text extraction for Japanese documents where numbers were extracted as special unicode points (#973). This only affects the docker setup, when not using the docker images you need to setup tesseract to use different training data for Japanese.
Rest API Changes
Complete 📄 diff (need to click the Files changed tab)
- The routes to fetch a list of tags, organizations, persons, fields
etc can now optionally take a
sort
query parameter to specify how to order the list. - ➕ Added
/sec/collective/emptytrash/startonce
to run the task to empty the trash immediately - The search endpoints can now take an optional parameter
searchMode
that defines whether to search in trashed items or not - Deleting an item via the api now only changes its state to Trashed
- ➕ Added
/sec/item/{id}/restore
to restore a trashed item (unless it has been deleted from the database). - ➕ Added
/sec/items/restoreAll
to restore multiple of trashed items - ➕ Added
/sec/items/merge
that accepts a POST request with a list of items to merge. The first item is the "target" item. All other items are deleted after the merge was successful. - The
ScanMailboxSettings
,Source
andItemUploadMeta
structures now contains a boolean fieldattachmentsOnly
ItemInsights
structure now contains a counter for trashed itemsCollectiveSettings
structure now has a section to specify settings for periodically deleting trashed items.
🔧 Configuration Changes
- ⚡️ Joex: A new section for configuring the update task has been added.
See section
update-check
in the default config file.
-
v0.25.1 Changes
Jul 29, 2021
- 🛠 Fix solr fulltext search by adding the new japanese content field
The SOLR fulltext search is broken in 0.25.0, so this is a fixup 🚀 release.
-
v0.25.0 Changes
Jul 29, 2021
- Introducing a new CLI tool (#345) that replaces all the shell
scripts from the
tools/
directory! https://github.com/docspell/dsc - 💻 UI changes:
- year separators are now more prominent (#950)
- fixes a bug in the item counter in detail view when an item is deleted (#920)
- German translation improvements (#901)
- The number of selected files is shown in upload page (#896)
- The created date of an item can now be used in queries (#925, #958)
- Setting tags api has been improved (#955)
- Task for converting pdfs is now behind the admin secret (#949)
- Task for generating preview images is now behind the admin secret (#915)
- respond with 404 when the source-id is not correct (#931)
- ⚡️ Update of core libraries (#890)
- ➕ Add Japanese to the list of document languages. Thanks @wallace11 for helping out (#948, #962)
- 🛠 Fix setting the folder from metadata when processing a file and allow to specifiy it by name or id (#940)
- 🛠 Fixes docspell config file in docker-compose setup (#909)
- 🛠 Fixes selecting the next job in the job executor (#898)
- 🛠 Fixes a bug that prevents uploading more than one file at once (#938)
Rest API Changes
- ✂ Removed
sec/item/convertallpdfs
endpoint in favor for newadmin/attachments/convertallpdfs
endpoint which is now an admin task - ✂ Removed
sec/collective/previews
endpoint, in favor for newadmin/attachments/generatePreviews
endpoint which is now an admin task to generate previews for all files. The now removed enpoint did this only for one collective. /sec/item/{id}/tags
: Setting tags to an item (replacing existing tags) has been changed to allow tags to be specified as names or ids- 🚚
/sec/item/{id}/tagsremove
: Added a route to remove tags for a single item
🔧 Configuration Changes
None.
- Introducing a new CLI tool (#345) that replaces all the shell
scripts from the
-
v0.24.0 Changes
Jun 18, 2021
🌐 This time a translation of the Web-UI in German is included and the 🚀 docker build was overhauled. The releases are now build and tested using Java 11.
- 🐳 Rework Docker setup. Images are now provided for different architectures and have a new home now (see below). The images are now built via a github-action from the official packages of each release. (#635, #643, #840, #687)
- 🌐 Translation of the UI into German (thanks to @monnypython for proof reading and applying lots of corrections!) (#292, #683, #870)
- 👌 Improve migration of SOLR (#604)
- The information whether solr has been setup, is now stored inside SOLR. This means when upgrading Docspell, all data will be re-indexed.
- ➕ Add
--exclude
and--include
options to theconsumedir.sh
script (#885) - 👌 Improved documenation of the http api (#874)
- ✂ Removed unused libraries in the final packages to reduce file size a bit (#841)
- 🐛 Bug: Searching by tag category was broken when using upper case letters (#849)
- 🐛 Bug: when adding a boolean custom field, it must be applied immediatly (#842)
- 🐛 Bug: when entering a space in a dropdown the menu closes (#863)
- 🐛 Bug: Some scripts didn't work with earlier versions of
jq
(#851) - 🐛 Bug: The source form was broken in that it didn't load the language correctly (#877)
- 🐛 Bug: Tag category options were wrongly populated when narrowing tags via a search (#880)
💥 Breaking Changes
Java 11
🏗 Not really a breaking change. Docspell is now build and tested using 📄 Java 11. Docspell has a small amount of Java source code. This is compiled using Java 11 but to target Java 8 JVMs. So it still can run under Java 8. However, it is recommended to use at least Java 11 to 📄 run Docspell.
🐳 Docker Images
🐳 The docker images are now pushed to the 🐳 docspell organization at 🐳 docker-hub! So the images are now:
- 📄
docspell/restserver
- 📄
docspell/joex
- 📄
docspell/tools
🏷 Tags: images are tagged with two floating tags:
nightly
and ✅latest
. Thenightly
tag always points to the latest development ✅ state (the master branch). Thelatest
tag points to the latest 🚀 release. Each release is also tagged with its version number, likev0.24.0
.The images changed slightly in that there is no assumption on where 📄 the config file is placed. Now you need to pass the docspell config file explicitely when using the images.
🏗 Multiarch: Images are now build for
amd64
,arm64
andarmv7
.📄 The consumedir is being replaced by the more generic
docspell/tools
image which contains all the scripts from thetools/
section. That means it has no special entrypoint for the consumedir script anymore. The polling functionality is now provided by the consumedir script. 🐳 And the docker-compose file needs now to specify the complete command arguments. This makes it much more flexible to use.This allows to use this image to run all the other tool scripts, too. 🛠 The scripts are in PATH inside the image and prefixed by
ds-
, so for exampleds-consumedir
ords-export-files
etc.🐳 Docker Compose
🐳 The docker-compose setup is now at
docker/docker-compose
. Please look at the new compose 🐳 file and do the corresponding changes at yours. Especially the consumedir container changed significantly. Then due to the fact that the config file must be given explicitely, you need to add this argument to each 📄 docspell component (restserver and joex) via acommand
section (see the compose file referenced above).The
.envrc
has been cleaned from some settings. Since the config files is mounted into the image, you can just edit this file instead. The only settings left in the .envrc file are those that need to be 🐳 available in the docker-compose file and the application. If some settings need to be duplicated for joex and restserver, you can use the builtin variable resolution mechanism for this. An example is provided in the new config file.🔧 Configuration Changes
None.
Rest API Changes
None.
-
v0.23.0 Changes
May 29, 2021
🚀 This release enables deleting multiple files at once of an item. It also changes how user settings are stored. Additionally several bugs 💻 in the ui and server have been fixed.
- 🔋 Feature: Central user settings (#565): user settings have been stored in the browser but are now stored at the server. This means that all settings are now shared across all devices. See below for notes on migrating your current settings.
- 🔋 Feature: Delete multiple attachemnts at once, thanks to @stefan-scheidewig (#626): multiple attachments on an item can be deleted with a single click
- 🔋 Feature: Make consumedir-cleaner run on windows, thanks to @JaCoB1123 (#809)
- 🐛 Bug: More work externalizing strings (#784, #760): many more strings have been externalized for being translated; also dates are now externalized, too
- 🐛 Bug: Better anonymous upload page (#758): the upload page for anonymous users shouldn't show a form to provide any metadata
- 🐛 Bug: Tag category color (#835): the input field to specify colors for tag categories didn't show the category name
- 🐛 Bug: Search in names (#822): a bug in the webui sent a broken query to the server, making the "search in names" field unusable
- 🐛 Bug: Fulltext only search broken (#823): the fulltext only search didn't only consult the solr index, but also the database, making it a lot slower and presenting the results not in the order returned by solr.
- 🐛 Bug: Ui switches to logged in state on auth failure (#814)
- 🐛 Bug: Broken search summary when tag has no category (#759)
💻 Migrating UI Settings
⬆️ After the upgrade to this version, your current ui settings are not 📄 read anymore. That means docspell starts up with a light theme and tag colors are gone etc. If there are no settings at the server, but 💻 docspell finds some at your browser, the UI Settings page shows a big message and a button. Clicking this button sends your settings to the server. This message disappears as soon as there are some settings on the server.
If you have multiple devices, you now need to choose one which settings you want to migrate to the server. It is currently not possible to store settings per device.
**Note: the button is only there if there are no settings at the server. So if you want to migrate, don't set the theme or click on other things that are persisted before doing the migration!
REST Api Changes
- 🆕 new routes have been added to delete multiple attachments of an item
- 🆕 new routes have been added to manage client settings
🔧 Configuration Changes
- none
-
v0.22.0 Changes
Apr 11, 2021
🚀 This release fixes some annoying bugs and prepares the web-ui to be translated into other languages. For actual translating them, I ask for your help. There is a detailed post about how to start with it in 🌐 the docs.
- 🔨 Refactor webui to prepare for localisation (#726)
- ➕ Add names to user defined tasks for better documentation (#712)
- 🛠 Fixes some ui bugs:
- scrollbar position (#722)
- other minor ui related fixes (#746)
- ✂ Removed deprecated api endpoints, fixing #482
- 🛠 Fixes bug where items are already shown in the ui, although still in processing (#719)
- Switch to github actions for ci (#748)
- 🛠 Fixes a bug in the new query language (#754)
- 🛠 Fix counters for categories in the search menu (#755)
REST Api Changes
- ✂ remove deprecated endpoints:
sec/item/searchForm
,sec/item/searchFormWithTags
,sec/item/searchFormStats
- ➕ adds category-count data to
SearchSummary
🔧 Configuration Changes
- none
-
v0.21.0 Changes
Mar 13, 2021
🚀 The main feature of this release gives a very flexible way of searching for documents, using a query.
- ➕ Add a query language to provide a flexible way for searching
- the search form now is translated into a search query
- allows to search for items not in a folder or not in a specific folder (#628, #379)
- Allows for range searches in custom fields (#540)
- And more! See the documentation
- ➕ Add a
use
attribute to all metadata, to be able to exclude them from suggestions (#659) - 👍 Allow to submit items for reprocessing via the UI (#365)
- ➕ Add Latvian language (#679)
- Scrollbars are back! (#681, #677)
- 👷 The
ds.sh
script was changed to inform the processing jobs to also check for duplicates (#653) - 🐳 Docker setup now uses again a fixed hostname (#608)
- ✅ Moving the unit tests to MUnit (#672)
- ✂ Remove the old UI code (#636)
- 🛠 Fix date extraction for English (#665)
- 🛠 Fix bug when reading contacts from extracted text (#709)
- 🛠 Fix bugs when reading mails (#691, #678)
- 🛠 Fix a bug that wouldn't show an error message when entering bad characters in the register form (#663)
- 🛠 Fixes a typo in the user settings menu (#654, thanks @ChristianKlass)
📄 Thanks to everyone showing interest in docspell and dedicating time by ✅ opening issues, testing and providing ideas!
REST Api Changes
Note there are breaking changes in the REST Api
- previous
search
andsearchWithTags
has been renamed tosearchForm
andsearchFormWithTags
, respectively - same with
searchStats
, it has been renamed tosearchFormStats
- The new
search
route can be used withGET
andPOST
requests and accepts now a search query and also a flag for whether returning details or not (there are no separate endpoints anymore) - The new
searchStats
accepts a query - The
ItemQuery
data structure is now only a query string, withoutlimit
andoffset
Organization
andPerson
have an additionaluse
attribute
🔧 Configuration Changes
🔧 There were no changes to the configuration files.
- ➕ Add a query language to provide a flexible way for searching