mirror of
https://github.com/danny-avila/LibreChat.git
synced 2025-09-22 06:00:56 +02:00
84 lines
2.9 KiB
Markdown
84 lines
2.9 KiB
Markdown
|
---
|
||
|
|
title: Facebook
|
||
|
|
description: Learn how to configure LibreChat to use Facebook for user authentication.
|
||
|
|
weight: -8
|
||
|
|
---
|
||
|
|
|
||
|
|
# Facebook - WIP
|
||
|
|
|
||
|
|
> ⚠️ **Warning: Work in progress, not currently functional**
|
||
|
|
|
||
|
|
> ❗ Note: Facebook Authentication will not work from `localhost`
|
||
|
|
|
||
|
|
## Create a Facebook Application
|
||
|
|
|
||
|
|
- Go to the **[Facebook Developer Portal](https://developers.facebook.com/)**
|
||
|
|
|
||
|
|
- Click on "My Apps" in the header menu
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Create a new application
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Select "Authenticate and request data from users with Facebook Login"
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Choose "No, I'm not creating a game"
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Provide an `app name` and `App contact email` and click `Create app`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Facebook Application Configuration
|
||
|
|
|
||
|
|
- In the side menu, select "Use cases" and click "Customize" under "Authentication and account creation."
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Add the `email permission`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Now click `Go to settings`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Ensure that `Client OAuth login`, `Web OAuth login` and `Enforce HTTPS` are **enabled**.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Add a `Valid OAuth Redirect URIs` and "Save changes"
|
||
|
|
- Example for a domain: `https://example.com/oauth/facebook/callback`
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Click `Go back` and select `Basic` in the `App settings` tab
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
- Click "Show" next to the App secret.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## .env Configuration
|
||
|
|
|
||
|
|
- Copy the `App ID` and `App Secret` and paste them into the `.env` file as follows:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
DOMAIN_CLIENT=https://your-domain.com # use http://localhost:3080 if not using a custom domain
|
||
|
|
DOMAIN_SERVER=https://your-domain.com # use http://localhost:3080 if not using a custom domain
|
||
|
|
|
||
|
|
FACEBOOK_CLIENT_ID=your_app_id
|
||
|
|
FACEBOOK_CLIENT_SECRET=your_app_secret
|
||
|
|
FACEBOOK_CALLBACK_URL=/oauth/facebook/callback
|
||
|
|
```
|
||
|
|
|
||
|
|
- Save the `.env` file.
|
||
|
|
|
||
|
|
> Note: If using docker, run `docker compose up -d` to apply the .env configuration changes
|