How to Install Docspell on Debian Latest

Docspell is a web-based document management system that helps you organize your documents and files efficiently. It allows you to capture your documents, index them, search and retrieve them easily. This tutorial will guide you on how to install Docspell on Debian Latest.

Prerequisites

Before we begin, make sure you have the following prerequisites in place:

  • A Debian Latest server or virtual machine
  • A user account with sudo privileges
  • Basic knowledge of the terminal

Step 1: Install OpenJDK

Docspell requires OpenJDK 11 or later. Follow the steps below to install OpenJDK on Debian Latest.

  1. Update the package index on your system with the command below:
sudo apt update
  1. Install OpenJDK 11 using the command below:
sudo apt install openjdk-11-jdk
  1. Verify that you have successfully installed OpenJDK 11 by running the command below:
java -version

The output should show the version of OpenJDK installed on your system.

Step 2: Download and Extract Docspell

In this step, we will download the latest release of Docspell from its official website and extract it.

  1. Download the latest stable release of Docspell using the following command:
wget https://github.com/eikek/docspell/releases/latest/download/docspell.zip
  1. Unzip the downloaded file using the command below:
unzip docspell.zip
  1. Move the extracted directory to the /opt directory using the command below:
sudo mv docspell /opt/

Step 3: Create a Systemd Service File

Create a systemd service file that will be used to manage Docspell as a service.

  1. Create a new service file using the command below:
sudo nano /etc/systemd/system/docspell.service
  1. Paste the following configuration into the file:
[Unit]
Description=Docspell Service
After=network.target

[Service]
Type=simple
User=<username>
WorkingDirectory=/opt/docspell/
ExecStart=/usr/bin/java -jar /opt/docspell/docspell-<version>.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target

Replace <username> with the username of the account with which you will run Docspell, and <version> with the version of Docspell you have installed.

  1. Save the changes made to the file by pressing Ctlr+X, then Y, and finally Enter.

  2. Reload the systemd daemon to load the new service unit file with the command below:

sudo systemctl daemon-reload

Step 4: Start and Enable Docspell

In this step, we will start and enable Docspell to run as a service.

  1. Start Docspell using the command below:
sudo systemctl start docspell
  1. Enable Docspell to run at startup using the command below:
sudo systemctl enable docspell
  1. Verify that the service is running by checking its status with the command below:
sudo systemctl status docspell

The output should show that the Docspell service is active and running.

Step 5: Access Docspell Web Interface

Docspell runs as a web application and can be accessed through your browser. Follow these steps to access the web interface:

  1. Open your browser and enter the following URL:
http://server-ip:8080/

Replace server-ip with the IP address of your Debian Latest server.

  1. You will be prompted with a login screen. Enter the default username and password, which is admin.

  2. After logging in, you can start using Docspell to manage your documents and files.

Conclusion

You have successfully installed and configured Docspell on Debian Latest. You can now start organizing and managing your documents and files using Docspell. If you encounter any issues, refer to the official Docspell documentation for further guidance.