Home
Page Index

Documize


Introduction

This guide explains how to install Documize Community on a fresh Ubuntu Server (20.04/22.04/24.04), set up PostgreSQL, and configure everything so Documize is ready to use.

1. Update the system

Always start with the latest updates:

sudo apt update && sudo apt upgrade -y

2. Install required dependencies

Always start with the latest updates:

sudo apt install -y wget curl ca-certificates tar

3. Install PostgreSQL

Run this command to install PostgreSQL:

sudo apt install -y postgresql postgresql-contrib

Enable and start PostgreSQL:

sudo systemctl enable --now postgresql

Check status:

sudo systemctl status postgresql

4. Create PostgreSQL database and user for Documize

Switch to the PostgreSQL admin account:

sudo -u postgres psql

Inside the PostgreSQL shell, run the following (replace the password with a strong one):

CREATE DATABASE documize;
CREATE USER docuser WITH ENCRYPTED PASSWORD 'StrongPasswordHere';
GRANT ALL PRIVILEGES ON DATABASE documize TO docuser;
\q

5. (Optional) Allow remote connections

If Documize runs on a different host than PostgreSQL, configure it

Instructions

Edit PostgreSQL config:

sudo nano /etc/postgresql/*/main/postgresql.conf

Set:

listen_addresses = '*'

Edit host-based authentication:

sudo nano /etc/postgresql/*/main/pg_hba.conf

Add (adjust subnet if needed):

host    documize    docuser    0.0.0.0/0    md5

Restart PostgreSQL:

sudo systemctl restart postgresql

6. Download Documize

Check the Documize Community releases for the latest version. Example:

wget https://github.com/documize/community/releases/download/v5.0.0/documize-community-linux-amd64.tar.gz
tar -zxvf documize-community-linux-amd64.tar.gz
cd documize-community-linux-amd64

7. Configure Documize

Documize uses the DATABASE_URL environment variable. Set it like this:

export DATABASE_URL=postgres://docuser:StrongPasswordHere@localhost:5432/documize?sslmode=disable&client_encoding=UTF8

To keep this permanent, add it to your shell profile:

echo 'export DATABASE_URL=postgres://docuser:StrongPasswordHere@localhost:5432/documize?sslmode=disable&client_encoding=UTF8' | sudo tee -a /etc/environment

8. Run Documize

Start Documize manually:

./documize --database-url "$DATABASE_URL"

By default, it runs on port 8080. Open in browser: http://SERVER-IP:8080

Follow the setup wizard to create your admin account.


9. (Optional) Run Documize as a systemd service

To keep Documize running in the background and auto-start on boot. Create a service file:

sudo nano /etc/systemd/system/documize.service

Add:

[Unit]
Description=Documize Community
After=network.target postgresql.service

[Service]
Type=simple
WorkingDirectory=/home/ubuntu/documize-community-linux-amd64
ExecStart=/home/ubuntu/documize-community-linux-amd64/documize --database-url=postgres://docuser:StrongPasswordHere@localhost:5432/documize?sslmode=disable&client_encoding=UTF8
Restart=always
User=ubuntu

[Install]
WantedBy=multi-user.target

Reload systemd and enable:

sudo systemctl daemon-reexec
sudo systemctl enable --now documize

Check status:

sudo systemctl status documize