starred/documenso

Fork 0

mirror of https://github.com/documenso/documenso.git synced 2026-04-24 21:36:01 +03:00

[GH-ISSUE #2527] Docker setup documentation missing required PostgreSQL environment variables #701

New issue

Open

opened 2026-02-26 18:48:07 +03:00 by kerem · 2 comments

kerem commented

2026-02-26 18:48:07 +03:00

Owner

Originally created by @Harshilmalhotra on GitHub (Feb 22, 2026).
Original GitHub issue: https://github.com/documenso/documenso/issues/2527

Issue Description

Problem

While setting up Documenso using the Docker Compose guide, the application fails to start due to missing environment variables that are not mentioned in the documentation.

The docker-compose command throws errors such as:

error while interpolating services.database.environment:
required variable POSTGRES_USER is missing a value

and

required variable NEXT_PRIVATE_DATABASE_URL is missing a value

Expected Behavior

The Docker setup documentation should include all required environment variables needed to successfully start the containers.

Missing Variables

The following variables appear to be required but are not documented in the setup guide:

POSTGRES_USER
POSTGRES_PASSWORD
POSTGRES_DB
NEXT_PRIVATE_DATABASE_URL
NEXT_PRIVATE_DIRECT_DATABASE_URL

Suggested Fix

Add these variables to the .env example section in the Docker deployment documentation so users can successfully run:

docker-compose --env-file ./.env up -d

Environment

OS: Ubuntu 22.04
Deployment method: Docker Compose
Documenso version: latest from repository

Steps to Reproduce

Follow the Docker setup instructions from the documentation.
Create a .env file using the variables listed in the guide.
Run:

docker-compose --env-file ./.env up -d

Docker Compose fails due to missing required environment variables.

Expected Behavior

The Docker Compose setup guide should include all required environment variables
needed to successfully start the containers.

Following the documentation steps should allow users to run:

docker-compose --env-file ./.env up -d

without encountering missing environment variable errors.

Current Behavior

No response

Screenshots (optional)

Operating System [e.g., Windows 10]

Docker

Browser [e.g., Chrome, Firefox]

No response

Version [e.g., 2.0.1]

No response

Please check the boxes that apply to this issue report.

I have searched the existing issues to make sure this is not a duplicate.
I have provided steps to reproduce the issue.
I have included relevant environment information.
I have included any relevant screenshots.
I understand that this is a voluntary contribution and that there is no guarantee of resolution.
I want to work on creating a PR for this issue if approved

Originally created by @Harshilmalhotra on GitHub (Feb 22, 2026). Original GitHub issue: https://github.com/documenso/documenso/issues/2527 ### Issue Description ## Problem While setting up Documenso using the Docker Compose guide, the application fails to start due to missing environment variables that are not mentioned in the documentation. The docker-compose command throws errors such as: error while interpolating services.database.environment: required variable POSTGRES_USER is missing a value and required variable NEXT_PRIVATE_DATABASE_URL is missing a value ## Expected Behavior The Docker setup documentation should include all required environment variables needed to successfully start the containers. ## Missing Variables The following variables appear to be required but are not documented in the setup guide: POSTGRES_USER POSTGRES_PASSWORD POSTGRES_DB NEXT_PRIVATE_DATABASE_URL NEXT_PRIVATE_DIRECT_DATABASE_URL ## Suggested Fix Add these variables to the `.env` example section in the Docker deployment documentation so users can successfully run: docker-compose --env-file ./.env up -d ## Environment - OS: Ubuntu 22.04 - Deployment method: Docker Compose - Documenso version: latest from repository ### Steps to Reproduce 1. Follow the Docker setup instructions from the documentation. 2. Create a `.env` file using the variables listed in the guide. 3. Run: docker-compose --env-file ./.env up -d 4. Docker Compose fails due to missing required environment variables. <img width="1242" height="333" alt="Image" src="https://github.com/user-attachments/assets/65cf41ab-a777-403f-ab63-029362658b1a" /> ### Expected Behavior The Docker Compose setup guide should include all required environment variables needed to successfully start the containers. Following the documentation steps should allow users to run: docker-compose --env-file ./.env up -d without encountering missing environment variable errors. ### Current Behavior _No response_ ### Screenshots (optional) <img width="1242" height="333" alt="Image" src="https://github.com/user-attachments/assets/e3f63249-13e5-46c7-b6f8-984ee83957b8" /> ### Operating System [e.g., Windows 10] Docker ### Browser [e.g., Chrome, Firefox] _No response_ ### Version [e.g., 2.0.1] _No response_ ### Please check the boxes that apply to this issue report. - [x] I have searched the existing issues to make sure this is not a duplicate. - [x] I have provided steps to reproduce the issue. - [x] I have included relevant environment information. - [x] I have included any relevant screenshots. - [x] I understand that this is a voluntary contribution and that there is no guarantee of resolution. - [x] I want to work on creating a PR for this issue if approved

kerem added the

status: triage

label

2026-02-26 18:48:07 +03:00

kerem commented

2026-02-26 18:48:07 +03:00

Author

Owner

@github-actions[bot] commented on GitHub (Feb 22, 2026):

Thank you for opening your first issue and for being a part of the open signing revolution!

One of our team members will review it and get back to you as soon as it possible 💚

Meanwhile, please feel free to hop into our community in Discord

@github-actions[bot] commented on GitHub (Feb 22, 2026): Thank you for opening your first issue and for being a part of the open signing revolution! <br /> One of our team members will review it and get back to you as soon as it possible 💚 <br /> Meanwhile, please feel free to hop into our community in [Discord](https://documen.so/discord)

kerem commented

2026-02-26 18:48:07 +03:00

Author

Owner

@Harshilmalhotra commented on GitHub (Feb 22, 2026):

I would be happy to submit a PR to fix the documentation if this approach is acceptable.

@Harshilmalhotra commented on GitHub (Feb 22, 2026): I would be happy to submit a PR to fix the documentation if this approach is acceptable.

kerem referenced this issue

2026-02-26 19:32:00 +03:00

[PR #721] [CLOSED] feat: add support for multiple documents format and conversion #1137

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/documenso#701

No description provided.

Rows
Columns