All Versions
42
Latest Version
Avg Release Cycle
27 days
Latest Release
-

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 to http://localhost:7880. If you are using docker: the docker-compose.yml in this repository has been updated. You can copy&paste the new env variable DOCSPELL_SERVER_INTERNAL__URL=http://docspell-restserver:7880 into your docker-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 and ItemUploadMeta structures now contains a boolean field attachmentsOnly
    • ItemInsights structure now contains a counter for trashed items
    • CollectiveSettings 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 new admin/attachments/convertallpdfs endpoint which is now an admin task
    • ✂ Removed sec/collective/previews endpoint, in favor for new admin/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.

  • 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 the consumedir.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. The nightly tag always points to the latest development ✅ state (the master branch). The latest tag points to the latest 🚀 release. Each release is also tagged with its version number, like v0.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 and armv7.

    📄 The consumedir is being replaced by the more generic docspell/tools image which contains all the scripts from the tools/ 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 example ds-consumedir or ds-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 a command 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 and searchWithTags has been renamed to searchForm and searchFormWithTags, respectively
    • same with searchStats, it has been renamed to searchFormStats
    • The new search route can be used with GET and POST 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, without limit and offset
    • Organization and Person have an additional use attribute

    🔧 Configuration Changes

    🔧 There were no changes to the configuration files.