2020-07-27 20:13:22 +00:00
|
|
|
+++
|
2022-01-27 19:23:15 +00:00
|
|
|
title = "Getting started"
|
2020-07-27 20:13:22 +00:00
|
|
|
weight = 0
|
|
|
|
|
+++
|
|
|
|
|
|
2022-01-27 19:23:15 +00:00
|
|
|
# Getting started
|
|
|
|
|
|
2020-07-27 20:13:22 +00:00
|
|
|
To get started, here are some quick links:
|
|
|
|
|
|
2021-05-31 11:25:57 +00:00
|
|
|
- Using [docker and docker-compose](@/docs/install/docker.md). This
|
|
|
|
|
sets up everything: all prerequisites, both docspell components and
|
2021-08-19 22:23:37 +00:00
|
|
|
a container running the [dsc
|
|
|
|
|
watch](@/docs/tools/cli.md#watch-a-directory) script to import files
|
|
|
|
|
that are dropped in a folder.
|
2021-05-31 11:25:57 +00:00
|
|
|
- [Download, Unpack and Run](@/docs/install/download_run.md). This
|
|
|
|
|
option is also very quick, but you need to check the
|
2020-07-27 20:13:22 +00:00
|
|
|
[prerequisites](@/docs/install/prereq.md) 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 `zip` and `deb` files. The files can be downloaded
|
2021-05-31 11:25:57 +00:00
|
|
|
from the [release
|
|
|
|
|
page](https://github.com/eikek/docspell/releases/latest).
|
|
|
|
|
- via the [nix package manager](@/docs/install/nix.md) and/or as a
|
|
|
|
|
[NixOS module](@/docs/install/nix.md#nixos). If you use nix/nixos,
|
|
|
|
|
you know what to do. The linked page contains some examples.
|
|
|
|
|
- [Unraid](https://www.unraid.net/): There are user provided [notes
|
|
|
|
|
and unraid
|
2020-12-22 20:06:08 +00:00
|
|
|
templates](https://github.com/vakilando/unraid-docker-templates)
|
2021-06-14 13:09:03 +00:00
|
|
|
which can get you started. There is also an [installation and help
|
|
|
|
|
thread](https://forums.unraid.net/topic/103425-docspell-hilfe/) in
|
|
|
|
|
the German Unraid forum. Thanks for providing these!
|
2021-01-25 07:50:46 +00:00
|
|
|
|
2022-01-27 19:23:15 +00:00
|
|
|
Every [component](@/docs/_index.md#components) (restserver,
|
2021-08-19 22:23:37 +00:00
|
|
|
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
|
2021-01-25 07:50:46 +00:00
|
|
|
simplicity, the docker-compose setup reflects this variant.
|
2021-05-31 11:25:57 +00:00
|
|
|
|
|
|
|
|
While there are many different ways to run docspell, at some point all
|
|
|
|
|
call docspell binaries. These accept one argument: a [config
|
|
|
|
|
file](@/docs/configure/_index.md). 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.
|
|
|
|
|
|
2022-01-27 19:23:15 +00:00
|
|
|
{% infobubble(title="Note") %}
|
2021-05-31 11:25:57 +00:00
|
|
|
|
2021-08-11 16:23:38 +00:00
|
|
|
Please have a look at the [configuration page](/docs/configure/) 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.
|
2021-05-31 11:25:57 +00:00
|
|
|
|
|
|
|
|
{% end %}
|
