Run the start script (in the corresponding
bin/ directory when using
the zip files):
$ ./docspell-restserver*/bin/docspell-restserver $ ./docspell-joex*/bin/docspell-joex
This will startup both components using the default configuration. The
configuration should be adopted to your needs. For example, the
database connection is configured to use a H2 database in the
directory. Please refer to the configuration
page for how to create a custom config
file. Once you have your config file, simply pass it as argument to
$ ./docspell-restserver*/bin/docspell-restserver /path/to/server-config.conf $ ./docspell-joex*/bin/docspell-joex /path/to/joex-config.conf
After starting the rest server, you can reach the web application at
/app, so using default values it would be
http://localhost:7880/app. There also is a redirect from
You should be able to create a new account and sign in. Check the configuration page to further customize docspell.
⚠ Please note
Please have a look at the configuration page page, before making docspell available in the internet. By default, everyone can create an account. This is great for trying out and using it in an internal network. But when opened up to the outside, it is recommended to lock this down.
Using the options below you can define how much memory the JVM process is able to use. This might be necessary to adopt depending on the usage scenario and configured text analysis features.
Please have a look at the corresponding configuration section.
The start scripts support some options to configure the JVM. One often used setting is the maximum heap size of the JVM. By default, java determines it based on properties of the current machine. You can specify it by given java startup options to the command:
$ ./docspell-restserver*/bin/docspell-restserver -J-Xmx1G -- /path/to/server-config.conf
This would limit the maximum heap to 1GB. The double slash separates
internal options and the arguments to the program. Another frequently
used option is to change the default temp directory. Usually it is
/tmp, but it may be desired to have a dedicated temp directory,
which can be configured:
$ ./docspell-restserver*/bin/docspell-restserver -J-Xmx1G -Djava.io.tmpdir=/path/to/othertemp -- /path/to/server-config.conf
$ ./docspell-restserver*/bin/docspell-restserver -h
gives an overview of supported options.
It is recommended to run joex with the G1GC enabled. If you use java8,
you need to add an option to use G1GC (
-XX:+UseG1GC), for java11
this is not necessary (but doesn't hurt either). This could look like
./docspell-joex-0.22.0/bin/docspell-joex -J-Xmx1596M -J-XX:+UseG1GC -- /path/to/joex.conf