Skip to main content

Logo Documenso

About

The Open Source DocuSign Alternative.

Configuration

Full environment variable configuration reference can be found in the Documenso documentation and in the Documenso GitHub repository.

Registration

The Cloudron package of Documenso is installed with public signup enabled:

/app/data/env
NEXT_PUBLIC_DISABLE_SIGNUP=false

When the app was installed with Cloudron user management enabled, each user has to login once while signup is enabled, so documenso creates the internal user record. Once all required users have been created, the public signup can be disabled by setting NEXT_PUBLIC_DISABLE_SIGNUP to true and then restarting the app.

Signing certificate

For the digital signature of your documents, you need a signing certificate in .p12 format (public and private key).

You can either upload an existing one or generate a new one.

Existing certificate

If you already have a signing certificate, upload it as /app/data/resources/cert.p12 using the File Manager.

If the certificate has a passphrase, set it in /app/data/env file:

ENV
NEXT_PRIVATE_SIGNING_PASSPHRASE={YourStrongPassHere}

Restart the app for the changes to take effect.

Generate certificate

To create a self-signed certificate, open a web terminal and run the following commands:

Bash
cd /run

# Generate private key
openssl genrsa -out private.key 2048

# Generate self-signed certificate valid for 10 years
openssl req -new -x509 -key private.key -out certificate.crt -days 3650

# Create p12 certificate. password is optional
openssl pkcs12 -export -out cert.p12 -inkey private.key -in certificate.crt -legacy

# Move cert into Documenso
mv /run/cert.p12 /app/data/resources/cert.p12
chown cloudron:cloudron /app/data/resources/cert.p12

If you set an optional password, open File Manager and put passphrase into /app/data/env file:

ENV
NEXT_PRIVATE_SIGNING_PASSPHRASE={YourStrongPassHere}

Restart the app for changes to take effect.