Skip to content

Commit 9361afc

Browse files
authored
πŸ–‹οΈ docs: Formatting Fix (danny-avila#1726)
* πŸƒ docs: Formatting Fix * πŸ–‹οΈ docs: Formatting Fix * πŸ–‹οΈ docs: Formatting Fix
1 parent beddce7 commit 9361afc

File tree

6 files changed

+64
-48
lines changed

6 files changed

+64
-48
lines changed

β€Ždocs/features/manage_your_database.md

Lines changed: 27 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ To enhance the security of your data, external ports for MongoDB are not exposed
1818

1919
Mongo Express allows you to interact with your MongoDB database through your browser. To set it up, perform the following steps:
2020

21-
1. Create a new file named `docker-compose.override.yml` in the same directory as your main `docker-compose.yml` file for LibreChat.
22-
23-
2. Copy the following contents into the `docker-compose.override.yml` file:
21+
### Setting up Mongo Express service
22+
- Create a new file named `docker-compose.override.yml` in the same directory as your main `docker-compose.yml` file for LibreChat.
23+
- Copy the following contents into the `docker-compose.override.yml` file:
2424

2525
```yaml
2626
version: '3.4'
@@ -39,55 +39,49 @@ services:
3939
- mongodb
4040
restart: always
4141
```
42-
43-
3. **Security Notice:**
44-
42+
### Security Notice
4543
- Before using this configuration, replace `admin` and `password` with a unique username and password for accessing Mongo Express. These credentials should be strong and not easily guessable to prevent unauthorized access.
4644
- Optional: You can also add native authentication to your database. See the [`docker-compose.override` guide](../install/configuration/docker_override.md#mongodb-authentication) for instructions on how to do so.
47-
- If utilizing authentication, ensure the admin user has the "clusterAdmin" and "readAnyDatabase" permissions. These steps are detailed in the [docker-compose.override guide](../install/configuration/docker_override.md#step-1-creating-an-admin-user).
48-
- After following the guide to authenticate MongoDB, you will need these variables under the environment section for mongo-express:
49-
50-
```yaml
51-
environment:
52-
ME_CONFIG_MONGODB_SERVER: mongodb
53-
ME_CONFIG_BASICAUTH_USERNAME: admin
54-
ME_CONFIG_BASICAUTH_PASSWORD: password
55-
# database authentication variables, using example credentials from guide
56-
ME_CONFIG_MONGODB_URL: 'mongodb://adminUser:securePassword@mongodb:27017'
57-
ME_CONFIG_MONGODB_ADMINUSERNAME: adminUser
58-
ME_CONFIG_MONGODB_ADMINPASSWORD: securePassword
59-
```
60-
61-
4. Save the `docker-compose.override.yml` file and run the following command from the directory where your `docker-compose.yml` file is located to start Mongo-Express along with your other Docker services:
45+
- If utilizing authentication, ensure the admin user has the "clusterAdmin" and "readAnyDatabase" permissions. These steps are detailed in the [docker-compose.override guide](../install/configuration/docker_override.md#step-1-creating-an-admin-user).
46+
- After following the guide to authenticate MongoDB, you will need these variables under the environment section for mongo-express:
47+
48+
```yaml
49+
environment:
50+
ME_CONFIG_MONGODB_SERVER: mongodb
51+
ME_CONFIG_BASICAUTH_USERNAME: admin
52+
ME_CONFIG_BASICAUTH_PASSWORD: password
53+
# database authentication variables, using example credentials from guide
54+
ME_CONFIG_MONGODB_URL: 'mongodb://adminUser:securePassword@mongodb:27017'
55+
ME_CONFIG_MONGODB_ADMINUSERNAME: adminUser
56+
ME_CONFIG_MONGODB_ADMINPASSWORD: securePassword
57+
```
58+
59+
### Launching and accessing Mongo Express
60+
- Save the `docker-compose.override.yml` file and run the following command from the directory where your `docker-compose.yml` file is located to start Mongo-Express along with your other Docker services:
6261

6362
```
6463
docker-compose up -d
6564
```
66-
6765
This command will merge the `docker-compose.override.yml` with your `docker-compose.yml` and apply the configuration.
6866

69-
5. Once Mongo-Express is up and running, access it by navigating to `http://localhost:8081` in your web browser. You'll need to enter the username and password you specified for `ME_CONFIG_BASICAUTH_USERNAME` and `ME_CONFIG_BASICAUTH_PASSWORD`.
67+
- Once Mongo-Express is up and running, access it by navigating to `http://localhost:8081` in your web browser. You'll need to enter the username and password you specified for `ME_CONFIG_BASICAUTH_USERNAME` and `ME_CONFIG_BASICAUTH_PASSWORD`.
7068

7169
---
7270

7371
## Removing Mongo Express
74-
7572
If you wish to remove Mongo-Express from your Docker environment, follow these straightforward steps:
73+
- Navigate to the directory containing your `docker-compose.yml` and `docker-compose.override.yml` files.
7674

77-
1. Navigate to the directory containing your `docker-compose.yml` and `docker-compose.override.yml` files.
78-
79-
2. Bring down the current Docker environment, which will stop and remove all running containers defined in the `docker-compose.yml` and `docker-compose.override.yml` files. Use the following command:
80-
81-
```
75+
- Bring down the current Docker environment, which will stop and remove all running containers defined in the `docker-compose.yml` and `docker-compose.override.yml` files. Use the following command:
76+
```sh
8277
docker-compose down
8378
```
8479

85-
3. Now you can either rename or delete the `docker-compose.override.yml` file, which contains the Mongo Express configuration.
86-
87-
4. Finally, bring your Docker environment back up, which will now exclude Mongo Express:
80+
- Now you can either rename or delete the `docker-compose.override.yml` file, which contains the Mongo Express configuration.
8881

82+
- Finally, bring your Docker environment back up, which will now exclude Mongo Express:
8983
```
9084
docker-compose up -d
9185
```
9286

93-
By following these steps, you will have successfully removed Mongo Express from your Docker environment. If you want to reinstate Mongo Express at a later time, you can either rename the backup file back to `docker-compose.override.yml` or recreate the original `docker-compose.override.yml` file with the Mongo Express configuration.
87+
> By following these steps, you will have successfully removed Mongo Express from your Docker environment. If you want to reinstate Mongo Express at a later time, you can either rename the backup file back to `docker-compose.override.yml` or recreate the original `docker-compose.override.yml` file with the Mongo Express configuration.

β€Ždocs/install/configuration/ai_setup.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -410,6 +410,7 @@ To use Azure with the Plugins endpoint, make sure the following environment vari
410410
## [OpenRouter](https://openrouter.ai/)
411411

412412
**[OpenRouter](https://openrouter.ai/)** is a legitimate proxy service to a multitude of LLMs, both closed and open source, including:
413+
413414
- OpenAI models (great if you are barred from their API for whatever reason)
414415
- Anthropic Claude models (same as above)
415416
- Meta's Llama models
@@ -422,18 +423,19 @@ OpenRouter is integrated to the LibreChat by overriding the OpenAI endpoint.
422423

423424
**Important**: As of v0.6.6, you can use OpenRouter as its own standalone endpoint:
424425

426+
### [Review the Custom Config Guide (click here)](./custom_config.md) to add an `OpenRouter` Endpoint
427+
425428
![image](https://github.com/danny-avila/LibreChat/assets/110412045/4955bfa3-7b6b-4602-933f-daef89c9eab3)
426429

427-
### [Review the Custom Config Guide (click here)](./custom_config.md) to add an `OpenRouter` Endpoint
430+
#### Setup (legacy):
428431

429-
**Setup (legacy):**
430432
- Signup to **[OpenRouter](https://openrouter.ai/)** and create a key. You should name it and set a limit as well.
431433
- Set the environment variable `OPENROUTER_API_KEY` in your .env file to the key you just created.
432434
- Set something in the `OPENAI_API_KEY`, it can be anyting, but **do not** leave it blank or set to `user_provided`
433435
- Restart your LibreChat server and use the OpenAI or Plugins endpoints.
434436

435-
**Notes:**
436-
- [TODO] **In the future, you will be able to set up OpenRouter from the frontend as well.**
437+
#### Notes (legacy):
438+
437439
- This will override the official OpenAI API or your reverse proxy settings for both Plugins and OpenAI.
438440
- On initial setup, you may need to refresh your page twice to see all their supported models populate automatically.
439441
- Plugins: Functions Agent works with OpenRouter when using OpenAI models.

β€Ždocs/install/configuration/docker_override.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,7 @@ Use of the `docker-compose.override.yml` file allows us to enable explicit authe
100100
- While the steps outlined may also be applicable to Docker Desktop environments, or with non-Docker, local MongoDB, or other container setups, details specific to those scenarios are not provided.
101101

102102
**There are 3 basic steps:**
103+
103104
- Create an admin user within your mongodb container
104105
- Enable authentication and create a "readWrite" user for "LibreChat"
105106
- Configure the MONGO_URI with newly created user

β€Ždocs/install/configuration/dotenv.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -422,45 +422,45 @@ AZURE_AI_SEARCH_SEARCH_OPTION_SELECT=
422422
- `DALLE_API_KEY`: This environment variable is intended for storing the OpenAI API key that grants access to both DALL-E 2 and DALL-E 3 services. Typically, this key should be kept private. If you are distributing a plugin or software that integrates with DALL-E, you may choose to leave this commented out, requiring the end user to input their own API key. If you have a shared API key you want to distribute with your software (not recommended for security reasons), you can uncomment this and provide the key.
423423

424424
```bash
425-
# DALLE_API_KEY=
425+
DALLE_API_KEY=
426426
```
427427

428428
- `DALLE3_API_KEY` and `DALLE2_API_KEY`: These are similar to the above but are specific to each version of DALL-E. They allow for separate keys for DALL-E 2 and DALL-E 3, providing flexibility if you have different access credentials or subscription levels for each service.
429429

430430
```bash
431-
# DALLE3_API_KEY=
432-
# DALLE2_API_KEY=
431+
DALLE3_API_KEY=
432+
DALLE2_API_KEY=
433433
```
434434

435435
**System Prompts:**
436436
- `DALLE3_SYSTEM_PROMPT` and `DALLE2_SYSTEM_PROMPT`: These variables allow users to set system prompts that can preconfigure or guide the image generation process for DALL-E 3 and DALL-E 2, respectively. Use these to set default prompts or special instructions that affect how the AI interprets the user's input prompts.
437437

438438
```bash
439-
# DALLE3_SYSTEM_PROMPT="Your DALL-E-3 System Prompt here"
440-
# DALLE2_SYSTEM_PROMPT="Your DALL-E-2 System Prompt here"
439+
DALLE3_SYSTEM_PROMPT="Your DALL-E-3 System Prompt here"
440+
DALLE2_SYSTEM_PROMPT="Your DALL-E-2 System Prompt here"
441441
```
442442

443443
**Reverse Proxy Settings:**
444444
- `DALLE_REVERSE_PROXY`: This setting enables the specification of a reverse proxy for DALL-E API requests. This can be useful for routing traffic through a specific server, potentially for purposes like caching, logging, or adding additional layers of security. Ensure that the URL follows the required pattern and is appropriately configured to handle DALL-E requests.
445445

446446
```bash
447-
# DALLE_REVERSE_PROXY=
447+
DALLE_REVERSE_PROXY=
448448
```
449449

450450
**Base URLs:**
451451
- `DALLE3_BASEURL` and `DALLE2_BASEURL`: These variables define the base URLs for DALL-E 3 and DALL-E 2 API endpoints, respectively. These might need to be set if you are using a custom proxy or a specific regional endpoint provided by OpenAI.
452452

453453
```bash
454-
# DALLE3_BASEURL=
455-
# DALLE2_BASEURL=
454+
DALLE3_BASEURL=
455+
DALLE2_BASEURL=
456456
```
457457

458458
**Azure OpenAI Integration (Optional):**
459459
- `DALLE3_AZURE_API_VERSION` and `DALLE2_AZURE_API_VERSION`: If you are using Azure's OpenAI service to access DALL-E, these environment variables specify the API version for DALL-E 3 and DALL-E 2, respectively. Azure may have specific API version strings that need to be set to ensure compatibility with their services.
460460

461461
```bash
462-
# DALLE3_AZURE_API_VERSION=
463-
# DALLE2_AZURE_API_VERSION=
462+
DALLE3_AZURE_API_VERSION=
463+
DALLE2_AZURE_API_VERSION=
464464
```
465465

466466
---

β€Ždocs/install/configuration/user_auth_system.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -202,6 +202,9 @@ EMAIL_FROM_NAME="My LibreChat Server"
202202
- Paste your `Client ID` and `Client Secret` in the `.env` file:
203203

204204
```bash
205+
DOMAIN_CLIENT=https://your-domain.com #use http://localhost:3080 if not using a custom domain
206+
DOMAIN_SERVER=https://your-domain.com #use http://localhost:3080 if not using a custom domain
207+
205208
DISCORD_CLIENT_ID=your_client_id
206209
DISCORD_CLIENT_SECRET=your_client_secret
207210
DISCORD_CALLBACK_URL=/oauth/discord/callback
@@ -279,6 +282,9 @@ DISCORD_CALLBACK_URL=/oauth/discord/callback
279282
- Copy the `App ID` and `App Secret` and paste them into the `.env` file as follows:
280283

281284
```bash
285+
DOMAIN_CLIENT=https://your-domain.com #use http://localhost:3080 if not using a custom domain
286+
DOMAIN_SERVER=https://your-domain.com #use http://localhost:3080 if not using a custom domain
287+
282288
FACEBOOK_CLIENT_ID=your_app_id
283289
FACEBOOK_CLIENT_SECRET=your_app_secret
284290
FACEBOOK_CALLBACK_URL=/oauth/facebook/callback
@@ -338,6 +344,9 @@ FACEBOOK_CALLBACK_URL=/oauth/facebook/callback
338344
![image](https://github.com/danny-avila/LibreChat/assets/138638445/aaf78840-48a9-44e1-9625-4109ed91d965)
339345

340346
```bash
347+
DOMAIN_CLIENT=https://your-domain.com #use http://localhost:3080 if not using a custom domain
348+
DOMAIN_SERVER=https://your-domain.com #use http://localhost:3080 if not using a custom domain
349+
341350
GITHUB_CLIENT_ID=your_client_id
342351
GITHUB_CLIENT_SECRET=your_client_secret
343352
GITHUB_CALLBACK_URL=/oauth/github/callback
@@ -429,6 +438,9 @@ GITHUB_CALLBACK_URL=/oauth/github/callback
429438
- Add them to your `.env` file:
430439

431440
```bash
441+
DOMAIN_CLIENT=https://your-domain.com #use http://localhost:3080 if not using a custom domain
442+
DOMAIN_SERVER=https://your-domain.com #use http://localhost:3080 if not using a custom domain
443+
432444
GOOGLE_CLIENT_ID=your_client_id
433445
GOOGLE_CLIENT_SECRET=your_client_secret
434446
GOOGLE_CALLBACK_URL=/oauth/github/callback
@@ -535,6 +547,9 @@ You can now make last minute changes, click on `Create user pool` when you're do
535547
6. Open the `.env` file at the root of your LibreChat folder and add the following variables with the values you copied:
536548

537549
```bash
550+
DOMAIN_CLIENT=https://your-domain.com #use http://localhost:3080 if not using a custom domain
551+
DOMAIN_SERVER=https://your-domain.com #use http://localhost:3080 if not using a custom domain
552+
538553
OPENID_CLIENT_ID=Your client ID
539554
OPENID_CLIENT_SECRET=Your client secret
540555
OPENID_ISSUER=https://cognito-idp.[AWS REGION].amazonaws.com/[USER POOL ID]/.well-known/openid-configuration
@@ -563,6 +578,9 @@ OPENID_CALLBACK_URL=/oauth/openid/callback
563578
10. Open the .env file in your project folder and add the following variables with the values you copied:
564579

565580
```bash
581+
DOMAIN_CLIENT=https://your-domain.com #use http://localhost:3080 if not using a custom domain
582+
DOMAIN_SERVER=https://your-domain.com #use http://localhost:3080 if not using a custom domain
583+
566584
OPENID_CLIENT_ID=Your Application (client) ID
567585
OPENID_CLIENT_SECRET=Your client secret
568586
OPENID_ISSUER=https://login.microsoftonline.com/Your Directory (tenant ID)/v2.0/

β€Ždocs/install/installation/linux_install.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -106,13 +106,14 @@ sudo apt-get install -y nodejs
106106

107107
### Using the command line (in the root directory)
108108
Setup the app:
109+
109110
1. Run `npm ci`
110111
2. Run `npm run frontend`
111112

112113
## Start the app:
113114
1. Run `npm run backend`
114115
2. Run `meilisearch --master-key put_your_meilesearch_Master_Key_here` (Only if SEARCH=TRUE)
115-
3. Visit http://localhost:3080 (default port) & enjoy
116+
3. Visit [http://localhost:3080](http://localhost:3080) (default port) & enjoy
116117

117118
### Using a shell script
118119

0 commit comments

Comments
Β (0)