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 configures the following defaults.

When selecting Allow all users on this Cloudron option on installation, the following environment variables are set in the /app/data/env file:

/app/data/env
NEXT_PUBLIC_DISABLE_SIGNUP=true
NEXT_PRIVATE_OIDC_ALLOW_SIGNUP=true
NEXT_PRIVATE_OIDC_SKIP_VERIFY=true

When selecting Leave user management to the app option on installation, the following environment variables are set in the /app/data/env file:

/app/data/env
NEXT_PUBLIC_DISABLE_SIGNUP=false

To enable or disable user registration after installation, you can change the NEXT_PUBLIC_DISABLE_SIGNUP variable in the /app/data/env file:

/app/data/env
NEXT_PUBLIC_DISABLE_SIGNUP={true|false}

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.