mirror of
https://github.com/TheAnachronism/docspell.git
synced 2024-11-13 02:31:10 +00:00
103 lines
2.8 KiB
Markdown
103 lines
2.8 KiB
Markdown
---
|
|
layout: docs
|
|
title: Quickstart
|
|
permalink: getit
|
|
---
|
|
|
|
# {{ page.title }}
|
|
|
|
You can download pre-compiled binaries from the [Release
|
|
Page](https://github.com/eikek/docspell/releases). There are `deb`
|
|
packages and generic zip files. Alternatively, docspell can be
|
|
installed via [nix](doc/nix) or docker (see below).
|
|
|
|
There are the following quick ways to get docspell to run on your
|
|
machine:
|
|
|
|
- [Download, Unpack, Run](#without-docker)
|
|
- [With Docker](#with-docker)
|
|
- [NixOs Module](doc/nix#docspell-as-a-service-on-nixos)
|
|
|
|
Check the [early demo video](demo) to see the basic idea. Refer to the
|
|
[documentation](doc) for more information on how to use docspell.
|
|
|
|
|
|
## Without Docker
|
|
|
|
### Prerequisite
|
|
|
|
Install Java (use your package manager or look
|
|
[here](https://adoptopenjdk.net/)).
|
|
|
|
OCR functionality requires the following tools:
|
|
|
|
- [tesseract](https://github.com/tesseract-ocr/tesseract),
|
|
- [ghostscript](http://pages.cs.wisc.edu/~ghost/) and possibly
|
|
- [unpaper](https://github.com/Flameeyes/unpaper).
|
|
|
|
The last is not really required, but improves OCR.
|
|
|
|
PDF conversion requires the following tools:
|
|
|
|
- [unoconv](https://github.com/unoconv/unoconv)
|
|
- [wkhtmltopdf](https://wkhtmltopdf.org/)
|
|
|
|
|
|
### Using zip files
|
|
|
|
You need to download the two files:
|
|
|
|
- [docspell-restserver-{{site.version}}.zip](https://github.com/eikek/docspell/releases/download/v{{site.version}}/docspell-restserver-{{site.version}}.zip)
|
|
- [docspell-joex-{{site.version}}.zip](https://github.com/eikek/docspell/releases/download/v{{site.version}}/docspell-joex-{{site.version}}.zip)
|
|
|
|
|
|
1. Unzip both files:
|
|
``` bash
|
|
$ unzip docspell-*.zip
|
|
```
|
|
2. Open two terminal windows and navigate to the the directory
|
|
containing the zip files.
|
|
3. Start both components executing:
|
|
``` bash
|
|
$ ./docspell-restserver*/bin/docspell-restserver
|
|
```
|
|
in one terminal and
|
|
``` bash
|
|
$ ./docspell-joex*/bin/docspell-joex
|
|
```
|
|
in the other.
|
|
4. Point your browser to: <http://localhost:7880/app>
|
|
5. Register a new account, sign in and try it.
|
|
|
|
|
|
## With Docker
|
|
|
|
There is a [docker-compose](https://docs.docker.com/compose/) setup
|
|
available in the `/docker` folder.
|
|
|
|
1. Clone the github repository
|
|
```bash
|
|
$ git clone https://github.com/eikek/docspell
|
|
```
|
|
2. Change into the `docker` directory:
|
|
```bash
|
|
$ cd docspell/docker
|
|
```
|
|
3. Run `docker-compose up`:
|
|
```bash
|
|
$ docker-compose up
|
|
```
|
|
4. Goto <http://localhost:7880>, signup and login
|
|
|
|
The directory contains a file `docspell.conf` that you can
|
|
[modify](doc/configure) as needed.
|
|
|
|
|
|
### Watching files in a directory
|
|
|
|
This setup starts a container running the
|
|
[`consumedir.sh`](doc/tools/consumedir) script. It is configured to
|
|
watch one directory and upload files arriving in there to docspell.
|
|
Please see the [`consumedir.sh`](doc/tools/consumedir#docker) docs for
|
|
additional steps.
|