Skip to content

docs: add COOKIE_DOMAIN usage in dotenv configuration #472

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.

Sign up for GitHub

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

Open
rajvatsal wants to merge 4 commits into
base: main
Choose a base branch
from
Open

docs: add COOKIE_DOMAIN usage in dotenv configuration #472

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
32950e8
docs: add COOKIE_DOMAIN usage in dotenv configuration
rajvatsal Dec 28, 2025
5fdbe12
Merge branch 'main' into docs/env-variable-for-cookie-domain
rajvatsal Jan 24, 2026
dff645a
I accidentally remove this line in my previous commit
rajvatsal Jan 24, 2026
e1b55be
doc: improve description of what will happen when cookie is unset
rajvatsal Jan 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 15 additions & 1 deletion pages/docs/configuration/dotenv.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -177,6 +177,20 @@ To configure LibreChat for local use or custom domain deployment, set the follow
When deploying LibreChat to a custom domain, replace `http://localhost:3080` with your deployed URL
- e.g. `https://librechat.example.com`.

### Cookie Domain

By default cookies will be set without a domain attribute (browser default behavior).
To set authorization cookies on the parent domain, set the following env variable:

<OptionTable
options={[
['COOKIE_DOMAIN', 'string', 'Specifies the domain for Auth cookies', 'COOKIE_DOMAIN=https://example.com'],
]}
/>

Example above assumes that Librechat chat is hosted on a subdomain of `example.com`.
- e.g. `https://librechat.example.com`.

### Prevent Public Search Engines Indexing

By default, your website will not be indexed by public search engines (e.g. Google, Bing, …). This means that people will not be able to find your website through these search engines. If you want to make your website more visible and searchable, you can change the following setting to `false`
Expand Down Expand Up @@ -1483,4 +1497,4 @@ Notes:
- Leader election requires Redis to be enabled (`USE_REDIS=true`).
- These settings are only relevant for multi-instance deployments.
- The leader lease must be renewed before expiration to maintain leadership.
- If lease renewal fails after max attempts, the instance will relinquish leadership.
- If lease renewal fails after max attempts, the instance will relinquish leadership.