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
- Ubuntu server latest installed and configured
- Root or sudo user access to the server
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://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.