Tutorial: How to Install Docspell on Ubuntu Server

Docspell is an open-source document management system that enables users to index, search and manage documents in a standalone or client/server architecture. In this tutorial, we will show you how to install Docspell on Ubuntu server latest.

Prerequisites

Step 1: Update Ubuntu Server

Before installing any packages, make sure your Ubuntu server is up-to-date. Use the following commands.

sudo apt update
sudo apt upgrade

Step 2: Install OpenJDK

Docspell requires Java to run. In this tutorial, we will install OpenJDK.

sudo apt install openjdk-11-jdk

Verify the installation by running the following command.

java -version

You should see the version of OpenJDK that was installed.

Step 3: Install PostgresSQL

Docspell stores its data in a PostgreSQL database. Use the following command to install PostgresSQL.

sudo apt install postgresql

After the installation is complete, start and enable the PostgreSQL service with the following commands.

sudo systemctl start postgresql
sudo systemctl enable postgresql

Step 4: Create a Database and User

You need to create a database and user for Docspell in PostgreSQL.

sudo -u postgres createuser --pwprompt docspelluser
sudo -u postgres createdb docspelldb -O docspelluser

Enter a password for the docspelluser.

Step 5: Install Docspell

Download the latest version of Docspell from https://docspell.org/download.

Extract the downloaded archive by using the following command.

tar -xzf docspell-<version>.tar.gz

Move the extracted directory to the /opt directory.

sudo mv docspell-<version> /opt/docspell

Change the ownership of the docspell directory to the docspelluser.

sudo chown -R docspelluser:docspelluser /opt/docspell

Step 6: Configure Docspell

Copy the sample configuration file and adjust it according to your system.

sudo cp /opt/docspell/config/docspell.yml.sample /opt/docspell/config/docspell.yml
sudo nano /opt/docspell/config/docspell.yml

In the docspell.yml configuration file, change the database section to the following.

database:
  type: postgres
  user: docspelluser
  password: <password>
  dbname: docspelldb
  host: 127.0.0.1
  port: 5432

Replace <password> with the password you set for the docspelluser.

Step 7: Start Docspell

Start Docspell with the following command.

sudo /opt/docspell/bin/docspell

Step 8: Access Docspell

Open your web browser and go to http://:8080. You should see the Docspell login page. Use the default username admin and password admin to log in.

You can now start using Docspell to manage all of your documents.

Final Thoughts

In this tutorial, we have shown you how to install Docspell on Ubuntu server latest. Remember to secure your system and configure backups to ensure that your data is safe.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!