mirror of
https://github.com/danny-avila/LibreChat.git
synced 2025-09-22 06:00:56 +02:00
Enhanced Documentation: Added Cloudflare and Linode Setup (#549)
* Add files via upload * Create linode-setup.md * Create cloudflare-setup.md * Update cloudflare-setup.md * Delete 4-linode.png * Delete 3-linode.png * Add files via upload * Add files via upload * Update cloudflare-setup.md * Update linode-setup.md * Rename cloudflare-setup.md to cloudflare.md * Rename linode-setup.md to linode.md * Update mkdocs.yml * Update cloudflare.md * Update linode.md * Update README.md * Update README.md * Update linode.md sentence in Italian
This commit is contained in:
parent
25211d6f23
commit
abd1b10b46
10 changed files with 153 additions and 0 deletions
|
@ -88,6 +88,8 @@ Keep up with the latest updates by visiting the releases page - [Releases](https
|
|||
|
||||
* [Hetzner](docs/deployment/hetzner_ubuntu.md)
|
||||
* [Heroku](docs/deployment/heroku.md)
|
||||
* [Linode](docs/deployment/linode.md)
|
||||
* [Cloudflare](docs/deployment/cloudflare.md)
|
||||
</details>
|
||||
|
||||
<details>
|
||||
|
|
BIN
docs/assets/1-cloudflare.png
Normal file
BIN
docs/assets/1-cloudflare.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 123 KiB |
BIN
docs/assets/1-linode.png
Normal file
BIN
docs/assets/1-linode.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 24 KiB |
BIN
docs/assets/2-cloudflare.png
Normal file
BIN
docs/assets/2-cloudflare.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 160 KiB |
BIN
docs/assets/2-linode.png
Normal file
BIN
docs/assets/2-linode.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 27 KiB |
BIN
docs/assets/Cloudflare-logo.jpg
Normal file
BIN
docs/assets/Cloudflare-logo.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 24 KiB |
BIN
docs/assets/linode-logo.jpg
Normal file
BIN
docs/assets/linode-logo.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 76 KiB |
74
docs/deployment/cloudflare.md
Normal file
74
docs/deployment/cloudflare.md
Normal file
|
@ -0,0 +1,74 @@
|
|||
|
||||
[<img src="../assets/Cloudflare-logo.jpg" width="350">](https://www.cloudflare.com/)
|
||||
|
||||
## if you are new to Domain, here's a quick guide to use setup a domain with Cloudflare:
|
||||
|
||||
**Google Domains and Cloudflare**
|
||||
|
||||
- buy a domain at https://domains.google.com/
|
||||
- register a Cloudflare account at https://dash.cloudflare.com/sign-up
|
||||
- click on `add site` and add your domain
|
||||
- select `Free` and tap `continue` twice
|
||||
- copy the 2 Cloudflare's nameservers
|
||||
- go to https://domains.google.com/registrar/ and select your domain
|
||||
- in the dns tab select `Custom name servers`
|
||||
- click on `Switch to these settings` and enter the two Cloudflare nameservers that you copied before, then save
|
||||
- return to the cloudflare tab and tap on `Done, check nameservers`, then `finish later` and `Check nameservers` (this process can take about 5 minutes)
|
||||
- in the `DNS` tab select `Records` and `Add Record`
|
||||
|
||||

|
||||
|
||||
(in the Name section, if you use @ it will use you main domain, but if you want to use a subdomain write it in the Name section)
|
||||
- For example: if you want to acces with chat.yourdomain.com just set in the Name section `chat`
|
||||
|
||||
**NOTE:** You have to set yourdomain.com the same way in both ngnix-proxy-manager and the Cloudflare records. So, if you have set it in the records as chat.yourdomain.com, you will also need to set chat.yourdomain.com in ngnix-proxy-manager."
|
||||
|
||||
## Cloudflare Zero Trust extra protection (optional)
|
||||
|
||||
If you want to use LibreChat exclusively for yourself or your family and set up an additional layer of protection, you can utilize Cloudflare Zero Trust. Here's how:
|
||||
|
||||
**Install Cloudflare Tunnel:**
|
||||
|
||||
- Go to `https://dash.cloudflare.com/`.
|
||||
- On the left side, click on **Zero Trust**.
|
||||
- Provide a casual name (which you can change later).
|
||||
- Select the free plan and proceed to payment (if you choose the free plan, you will not be charged).
|
||||
- Open the **Access** tab, navigate to **Tunnels**, and click on **Create a tunnel**.
|
||||
- Set up a tunnel name (e.g., `my-linode-server`) and save the tunnel.
|
||||
- Choose where you want to install Cloudflare Tunnel (I recommend using Docker).
|
||||
- If you choose Docker: Simply copy the displayed command and paste it into the terminal. Before running it, add `-d` after `docker run`, like this: `docker run -d cloudflare/cloudflared:latest...` (this will run the Docker process in the background).
|
||||
- In the **Public Hostname** tab, select **Add a public hostname**.
|
||||
|
||||

|
||||
|
||||
|
||||
|
||||
## Setup Application Login: (optional)
|
||||
|
||||
Setting up application login with Cloudflare Zero Trust adds extra security but is not recommended for most users because it requires authentication through Cloudflare Zero Trust before accessing LibreChat.
|
||||
|
||||
- On the left side, click on **Access**, then **Applications**, and add a new application.
|
||||
- Select **Self-hosted**, provide an **Application name**, and set a **Session Duration**.
|
||||
- In the **Application domain** field, enter the same settings you configured in the Tunnels tab. Then, click **Next**.
|
||||
- Set the **Policy name** as "auth" and in the **Configure rules** section, you can define variables for granting access to LibreChat for specific users. Here are some examples:
|
||||
- **Emails**: You can add specific email addresses that are allowed to access it.
|
||||
- **Email ending in**: You can add email addresses that end with a custom domain (e.g., @myorganization.com).
|
||||
- **GitHub organization**: You can restrict access to a specific GitHub organization.
|
||||
- Click **Next** and then **Add application**.
|
||||
|
||||
**NOTE:** If you have followed the "Setup Application Login" section, you must read the next part.
|
||||
|
||||
## Setup Authentication Method:
|
||||
|
||||
Currently, you can only access Cloudflare Zero Trust using a PIN. Below are guides that explain how to add popular social login methods:
|
||||
|
||||
- GitHub: [GitHub Integration Guide](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/github)
|
||||
- Google: [Google Integration Guide](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/google/)
|
||||
- Facebook: [Facebook Integration Guide](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/facebook-login/)
|
||||
- LinkedIn: [LinkedIn Integration Guide](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/linkedin/)
|
||||
- If you want to use a different authentication method, refer to this list: [Identity Providers Integration](https://developers.cloudflare.com/cloudflare-one/identity/idp-integration/)
|
||||
|
||||
After adding at least one login method, return to the **Applications** section, select your application, go to **Configure**, and click on **Authentication**.
|
||||
- Turn off "Accept all available identity providers".
|
||||
- Select your social login method and deselect "One-time PIN".
|
||||
- Click on **Save application**.
|
75
docs/deployment/linode.md
Normal file
75
docs/deployment/linode.md
Normal file
|
@ -0,0 +1,75 @@
|
|||
|
||||
[<img src="../assets/linode-logo.jpg" width="250">](https://www.linode.com/)
|
||||
|
||||
# Linode (⚠️Payment required)
|
||||
|
||||
**Create a Linode Account and a Linode Server**
|
||||
- Go to the Linode website (https://www.linode.com/) and click on the "Sign Up" or "Get Started" button.
|
||||
- Follow the instructions to create a new account by providing your personal details and payment information.
|
||||
- Once your account is created, you will have access to the Linode Cloud Manager.
|
||||
- Click on the "Create" button to create a new Linode server.
|
||||
- Choose a location for your server and select the desired server plan.
|
||||
- Configure the server settings such as the server's label, root password, and SSH key. If you don't know which image to use, select 🐧💻 Ubuntu 22.04 LTS
|
||||
- Click on the 'Create' button to provision the Linode server (wait about 5 minutes after the server is on, because the server is not actually powered on yet)
|
||||
|
||||
**Install Docker:**
|
||||
- Connect to your Linode server via SSH using a terminal or SSH client.
|
||||
- Run the following commands to install Docker and Docker-compose:
|
||||
|
||||
```
|
||||
sudo apt update
|
||||
sudo apt install docker.io && apt install docker-compose
|
||||
```
|
||||
## [Install LibreChat](../install/docker_install.md)
|
||||
|
||||
## Install and Setup NGINX Proxy Manager:
|
||||
|
||||
if you want, you can use NGINX, Apache, or any other proxy manager.
|
||||
|
||||
- create a folder
|
||||
|
||||
```
|
||||
mkdir ngnix-proxy-manager
|
||||
cd ngnix-proxy-manager
|
||||
```
|
||||
|
||||
- Create a file named `docker-compose.yml` by running `nano docker-compose.yml`.
|
||||
|
||||
- Add this code and save it with `Ctrl+X`, `Y`, and `Enter`:
|
||||
|
||||
```
|
||||
version: '3.8'
|
||||
services:
|
||||
app:
|
||||
image: 'jc21/nginx-proxy-manager:latest'
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
- '80:80'
|
||||
- '81:81'
|
||||
- '443:443'
|
||||
volumes:
|
||||
- ./data:/data
|
||||
- ./letsencrypt:/etc/letsencrypt
|
||||
```
|
||||
|
||||
- **Run** `docker-compose up -d` to start NGINX Proxy Manager
|
||||
|
||||
- Login to NGINX Proxy Manager and change the username and password.
|
||||
|
||||
The default login link is at `your_linode_ip:81`.
|
||||
|
||||
Default Admin User:
|
||||
|
||||
```
|
||||
Email: admin@example.com
|
||||
Password: changeme
|
||||
```
|
||||
|
||||
- Login to NGINX Proxy Manager.
|
||||
- Click on "Proxy Host" and add a proxy host.
|
||||
|
||||

|
||||
|
||||
- If you want, you can add the Let's Encrypt SSL certificate.
|
||||
|
||||

|
|
@ -75,6 +75,8 @@ nav:
|
|||
- Cloud Deployment:
|
||||
- Hetzner: 'deployment/hetzner_ubuntu.md'
|
||||
- Heroku: 'deployment/heroku.md'
|
||||
- Cloudflare: 'deployment/cloudflare.md'
|
||||
- Linode: 'deployment/linode.md'
|
||||
- Contributions:
|
||||
- Documentation Guidelines: 'contributions/documentation_guidelines.md'
|
||||
- Code Standards and Conventions: 'contributions/coding_conventions.md'
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue