4.0 KiB
+++ title = "Download & Run" weight = 22 +++
You can install via zip or deb archives. Please see the prerequisites first.
Using zip files
You need to download the two files:
- Unzip both files:
$ unzip docspell-*.zip - Open two terminal windows and navigate to the the directory containing the zip files.
- Start both components executing:
in one terminal and$ ./docspell-restserver*/bin/docspell-restserver
in the other.$ ./docspell-joex*/bin/docspell-joex - Point your browser to: http://localhost:7880/app
- Register a new account, sign in and try it.
Note, that this setup doesn't include watching a directory nor fulltext search. Using zip/deb files requires to take care of the prerequisites yourself.
The provided scripts in
docspell-tools-{{version()}}.zip
must be extracted and installed manually somewhere in your $PATH.
Using deb files
Packages are also provided at the release page:
The DEB packages can be installed on Debian, or Debian based Distros:
$ sudo dpkg -i docspell*.deb
Then the start scripts are in your $PATH. Run docspell-restserver
or docspell-joex from a terminal window.
The packages come with a systemd unit file that will be installed to autostart the services.
The provided scripts in docspell-tools-{{version()}}.zip must be
extracted and installed manually somewhere in your $PATH. There are
no deb files provided.
Running
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. 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 the command:
$ ./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
http://localhost:7880/.
You should be able to create a new account and sign in. When creating a new account, use the same name for collective and user and then login with this name.
Upgrading
Since downgrading is not supported, it is recommended to backup your database before upgrading. Should something not work as expected, restore the database backup and go back to the previous version.
When using the zip or deb files, either install the new deb files via your package manager or download and unpack the new zip files. You might want to have a look at the changelog, since it is sometimes necessary to modify the config file.
More
Fulltext Search
Fulltext search is powered by SOLR. You need to install solr and create a core for docspell. Then cange the solr url for both components (restserver and joex) accordingly. See the relevant section in the config page.
Watching a directory
The dsc tool with the watch subcommand can be
used for this. Using systemd or something similar, it is possible to
create a system service that runs the script in "watch mode".