Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

#2627 adding documentation. updated order of pages, corrected typos #49

Merged
merged 2 commits into from
Jan 7, 2025

Conversation

DarioGii
Copy link
Contributor

@DarioGii DarioGii commented Jan 7, 2025

Documentation for External Database support (#2270)

External Database _ Stirling-PDF-1
External Database _ Stirling-PDF

ex_db

# Using an External Database

It is possible to use your own external database with Stirling PDF rather than the default H2 database if you wish.
PostgreSQL is currently supported with others soon to follow.
Copy link
Member

@Frooodle Frooodle Jan 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Others added on request not 'soon'

name: postgres
```

- `enableCustomDatabase`: Set this property to `true` to enable use of the custom database
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add note that they need enterprise license to use external DB feature

- `name`: The name of the custom database. This should match the name you have set for your database

### Docker Based Configuration
You can also configure an external database within using Docker.
Copy link
Member

@Frooodle Frooodle Jan 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think rather than doing a This or That approach with settings.yml and docker it might be better to use a tabbed function
here is a example
593e33d

https://docs.stirlingpdf.com/Advanced%20Configuration/UI%20Customisation

```

- `depends_on`: This specifies any services that your app will need in order to run. Ensure the name matches the container name for your database
- `DOCKER_ENABLE_SECURITY`: Set this to `true` to enable security features (required for external database configuration)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You mention this for the docker section but not the yaml section, perhaps a general section before these is needed to say you need security and enterprise etc?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah good shout!

POSTGRES_PASSWORD: "stirling"
```

*Example configuration can be found in `/exampleYmlFiles/docker-compose-latest-fat-security-postgres.yml`*
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can provide a github link here

@Frooodle Frooodle merged commit ed4efb2 into main Jan 7, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants