ae8bd1d85b
This commit introduces the ability to install Docspell from a Nix flake. There are no major changes to the logic of the previous modules outside of organizing them in a flake and adding a simple check script.
2.3 KiB
+++ title = "Getting started" weight = 0 +++
Getting started
To get started, here are some quick links:
- Using docker and docker-compose. This sets up everything: all prerequisites, both docspell components and a container running the dsc watch script to import files that are dropped in a folder.
- Download, Unpack and Run. This
option is also very quick, but you need to check the
prerequisites yourself. Database is
already setup, but you'd need to setup SOLR (when using fulltext
search) and install some programs for the joex component. This
applies to the
zipanddebfiles. The files can be downloaded from the release page. - via the nix package manager and/or as a NixOS module through a flake. If you use nix/nixos, you know what to do. The linked page contains some examples.
- Unraid: There are user provided notes and unraid templates which can get you started. There is also an installation and help thread in the German Unraid forum. Thanks for providing these!
Every component (restserver, joex, dsc watch) can run on different machines and multiple times. Most of the time running all on one machine is sufficient and also for simplicity, the docker-compose setup reflects this variant.
While there are many different ways to run docspell, at some point all call docspell binaries. These accept one argument: a config file. If this is not given, the default is used, which gets you started on a single machine, but it is very likely you want to change these to match your use-case/setup.
{% infobubble(title="Note") %}
Please have a look at the configuration page page, before making docspell publicly available. 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.
{% end %}