seg_yinzy
/
dify-docs
mirror of https://github.com/langgenius/dify-docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

GITBOOK-39: No subject

pull/33/head^2
John Wang 2024-01-18 05:26:13 +00:00 committed by gitbook-bot
parent ac0bed8c5c
commit 9da0c93a83
No known key found for this signature in database
GPG Key ID: 07D2180C7B12D0FF
1 changed files with 133 additions and 125 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

258
en/getting-started/install-self-hosted/environments.md
View File

@ -15,30 +15,29 @@ Deployment version.
* Unable to log in using email and password, only supports GitHub, Google authorization login.
* Has 200 trials hosted OpenAI API-Key feature
#### CONSOLE_API_URL
#### CONSOLE\_API\_URL
The backend URL of the console API, used to concatenate the authorization callback. If empty, it is the same domain. Example: `https://api.console.dify.ai`
#### CONSOLE_WEB_URL
#### CONSOLE\_WEB\_URL
The front-end URL of the console web, used to concatenate some front-end addresses and for CORS configuration use. If empty, it is the same domain. Example: `https://console.dify.ai`
#### SERVICE_API_URL
#### SERVICE\_API\_URL
Service API Url, used to display Service API Base Url to the front-end. If empty, it is the same domain. Example: `https://api.dify.ai`
#### APP_API_URL
#### APP\_API\_URL
WebApp API backend Url, used to declare the back-end URL for the front-end API. If empty, it is the same domain. Example: `https://app.dify.ai`
#### APP_WEB_URL
#### APP\_WEB\_URL
WebApp Url, used to display WebAPP API Base Url to the front-end. If empty, it is the same domain. Example: `https://api.app.dify.ai`
#### FILES\_URL
File preview or download URL prefix, used to display the file preview or download URL to the front-end or as a multi-modal model input;
In order to prevent others from forging, the image preview URL is signed and has a 5-minute expiration time.
File preview or download URL prefix, used to display the file preview or download URL to the front-end or as a multi-modal model input; In order to prevent others from forging, the image preview URL is signed and has a 5-minute expiration time.
### Server
@ -57,11 +56,11 @@ Startup mode, only available when starting with docker, not effective when start
Debug mode, default is false. It is recommended to turn on this configuration for local development to prevent some problems caused by monkey patch.
#### FLASK_DEBUG
#### FLASK\_DEBUG
Flask debug mode, it can output trace information at the interface when turned on, which is convenient for debugging.
#### SECRET_KEY
#### SECRET\_KEY
A key used to securely sign session cookies and encrypt sensitive information in the database.
@ -69,7 +68,7 @@ This variable needs to be set when starting for the first time.
You can use `openssl rand -base64 42` to generate a strong key.
#### DEPLOY_ENV
#### DEPLOY\_ENV
Deployment environment.
@ -80,25 +79,25 @@ Deployment environment.
Testing environment. There will be a distinct color label on the front-end page, indicating that this environment is a testing environment.
#### LOG_LEVEL
#### LOG\_LEVEL
Log output level, default is INFO.
It is recommended to set it to ERROR for production.
#### MIGRATION_ENABLED
#### MIGRATION\_ENABLED
When set to true, the database migration will be automatically executed when the container starts, only available when starting with docker, not effective when starting from source code.
You need to manually execute `flask db upgrade` in the api directory when starting from source code.
#### CHECK_UPDATE_URL
#### CHECK\_UPDATE\_URL
Whether to enable the version check policy. If set to false, `https://updates.dify.ai` will not be called for version check.
Since the version interface based on CloudFlare Worker cannot be directly accessed in China at present, setting this variable to empty can shield this interface call.
#### OPENAI_API_BASE
#### OPENAI\_API\_BASE
Used to change the OpenAI base address, default is [https://api.openai.com/v1](https://api.openai.com/v1).
@ -108,27 +107,27 @@ When OpenAI cannot be accessed in China, replace it with a domestic mirror addre
Only effective when starting with docker image or docker-compose.
* DIFY_BIND_ADDRESS
* DIFY\_BIND\_ADDRESS
API service binding address, default: 0.0.0.0, i.e., all addresses can be accessed.
* DIFY_PORT
* DIFY\_PORT
API service binding port number, default 5001.
* SERVER_WORKER_AMOUNT
* SERVER\_WORKER\_AMOUNT
The number of API server workers, i.e., the number of gevent workers. Formula: `number of cpu cores x 2 + 1`
Reference: [https://docs.gunicorn.org/en/stable/design.html#how-many-workers](https://docs.gunicorn.org/en/stable/design.html#how-many-workers)
* SERVER_WORKER_CLASS
* SERVER\_WORKER\_CLASS
Defaults to gevent. If using windows, it can be switched to sync or solo.
* GUNICORN_TIMEOUT
* GUNICORN\_TIMEOUT
Request handling timeout. The default is 200, it is recommended to set it to 360 to support a longer sse connection time.
* CELERY_WORKER_CLASS
* CELERY\_WORKER\_CLASS
Similar to `SERVER_WORKER_CLASS`. Default is gevent. If using windows, it can be switched to sync or solo.
* CELERY_WORKER_AMOUNT
* CELERY\_WORKER\_AMOUNT
The number of Celery workers. The default is 1, and can be set as needed.
@ -136,29 +135,29 @@ Only effective when starting with docker image or docker-compose.
The database uses PostgreSQL. Please use the public schema.
* DB_USERNAME: username
* DB_PASSWORD: password
* DB_HOST: database host
* DB_PORT: database port number, default is 5432
* DB_DATABASE: database name
* SQLALCHEMY_POOL_SIZE: The size of the database connection pool. The default is 30 connections, which can be appropriately increased.
* SQLALCHEMY_POOL_RECYCLE: Database connection pool recycling time, the default is 3600 seconds.
* SQLALCHEMY_ECHO: Whether to print SQL, default is false.
* DB\_USERNAME: username
* DB\_PASSWORD: password
* DB\_HOST: database host
* DB\_PORT: database port number, default is 5432
* DB\_DATABASE: database name
* SQLALCHEMY\_POOL\_SIZE: The size of the database connection pool. The default is 30 connections, which can be appropriately increased.
* SQLALCHEMY\_POOL\_RECYCLE: Database connection pool recycling time, the default is 3600 seconds.
* SQLALCHEMY\_ECHO: Whether to print SQL, default is false.
#### Redis Configuration
This Redis configuration is used for caching and for pub/sub during conversation.
* REDIS_HOST: Redis host
* REDIS_PORT: Redis port, default is 6379
* REDIS_DB: Redis Database, default is 0. Please use a different Database from Session Redis and Celery Broker.
* REDIS_USERNAME: Redis username, default is empty
* REDIS_PASSWORD: Redis password, default is empty. It is strongly recommended to set a password.
* REDIS_USE_SSL: Whether to use SSL protocol for connection, default is false
* REDIS\_HOST: Redis host
* REDIS\_PORT: Redis port, default is 6379
* REDIS\_DB: Redis Database, default is 0. Please use a different Database from Session Redis and Celery Broker.
* REDIS\_USERNAME: Redis username, default is empty
* REDIS\_PASSWORD: Redis password, default is empty. It is strongly recommended to set a password.
* REDIS\_USE\_SSL: Whether to use SSL protocol for connection, default is false
#### Celery Configuration
* CELERY_BROKER_URL
* CELERY\_BROKER\_URL
Format as follows:
@ -167,7 +166,7 @@ This Redis configuration is used for caching and for pub/sub during conversation
```
Example: `redis://:difyai123456@redis:6379/1`
* BROKER_USE_SSL
* BROKER\_USE\_SSL
If set to true, use SSL protocol for connection, default is false
@ -175,10 +174,10 @@ This Redis configuration is used for caching and for pub/sub during conversation
Used to set the front-end cross-domain access policy.
* CONSOLE_CORS_ALLOW_ORIGINS
* CONSOLE\_CORS\_ALLOW\_ORIGINS
Console CORS cross-domain policy, default is `*`, that is, all domains can access.
* WEB_API_CORS_ALLOW_ORIGINS
* WEB\_API\_CORS\_ALLOW\_ORIGINS
WebAPP CORS cross-domain policy, default is `*`, that is, all domains can access.
@ -186,7 +185,7 @@ Used to set the front-end cross-domain access policy.
Used to store uploaded data set files, team/tenant encryption keys, and other files.
* STORAGE_TYPE
* STORAGE\_TYPE
Type of storage facility
@ -195,91 +194,102 @@ Used to store uploaded data set files, team/tenant encryption keys, and other fi
Local file storage, if this option is selected, the following `STORAGE_LOCAL_PATH` configuration needs to be set.
* s3
S3 object storage, if this option is selected, the following S3_ prefixed configurations need to be set.
* STORAGE_LOCAL_PATH
S3 object storage, if this option is selected, the following S3\_ prefixed configurations need to be set.
* STORAGE\_LOCAL\_PATH
Default is storage, that is, it is stored in the storage directory of the current directory.
If you are deploying with docker or docker-compose, be sure to mount the `/app/api/storage` directory in both containers to the same local directory, otherwise, you may encounter file not found errors.
* S3_ENDPOINT: S3 endpoint address
* S3_BUCKET_NAME: S3 bucket name
* S3_ACCESS_KEY: S3 Access Key
* S3_SECRET_KEY: S3 Secret Key
* S3_REGION: S3 region information, such as: us-east-1
* S3\_ENDPOINT: S3 endpoint address
* S3\_BUCKET\_NAME: S3 bucket name
* S3\_ACCESS\_KEY: S3 Access Key
* S3\_SECRET\_KEY: S3 Secret Key
* S3\_REGION: S3 region information, such as: us-east-1
#### Vector Database Configuration
* VECTOR_STORE
- **Available enumeration types include：**
- `weaviate`
- `qdrant`
- `milvus`
- `zilliz` (share the same configuration as `milvus`)
- `pinecone` (not yet open)
* WEAVIATE_ENDPOINT
* VECTOR\_STORE
* **Available enumeration types include：**
* `weaviate`
* `qdrant`
* `milvus`
* `zilliz` (share the same configuration as `milvus`)
* `pinecone` (not yet open)
* WEAVIATE\_ENDPOINT
Weaviate endpoint address, such as: `http://weaviate:8080`.
* WEAVIATE_API_KEY
* WEAVIATE\_API\_KEY
The api-key credential used to connect to Weaviate.
* WEAVIATE_BATCH_SIZE
* WEAVIATE\_BATCH\_SIZE
The number of index Objects created in batches in Weaviate, default is 100.
Refer to this document: [https://weaviate.io/developers/weaviate/manage-data/import#how-to-set-batch-parameters](https://weaviate.io/developers/weaviate/manage-data/import#how-to-set-batch-parameters)
* WEAVIATE_GRPC_ENABLED
* WEAVIATE\_GRPC\_ENABLED
Whether to use the gRPC method to interact with Weaviate, performance will greatly increase when enabled, may not be usable locally, default is true.
* QDRANT_URL
* QDRANT\_URL
Qdrant endpoint address, such as: `https://your-qdrant-cluster-url.qdrant.tech/`
* QDRANT_API_KEY
* QDRANT\_API\_KEY
The api-key credential used to connect to Qdrant.
* PINECONE_API_KEY
* PINECONE\_API\_KEY
The api-key credential used to connect to Pinecone.
* PINECONE_ENVIRONMENT
* PINECONE\_ENVIRONMENT
The environment where Pinecone is located, such as: `us-east4-gcp`
* MILVUS_HOST
* MILVUS\_HOST
Milvus host configuration.
* MILVUS_PORT
* MILVUS\_PORT
Milvus port configuration.
* MILVUS_USER
* MILVUS\_USER
Milvus user configuration, default is empty.
* MILVUS_PASSWORD
* MILVUS\_PASSWORD
Milvus password configuration, default is empty.
* MILVUS_USE_SECURE
* MILVUS\_USE\_SECURE
Whether Milvus uses SSL connection, default is false.
#### Knowledge Configuration
* UPLOAD_FILE_SIZE_LIMIT:
* UPLOAD\_FILE\_SIZE\_LIMIT:
Upload file size limit, default 15M.
* UPLOAD_FILE_BATCH_LIMIT
Upload file size limit, default 15M.
* UPLOAD\_FILE\_BATCH\_LIMIT
The maximum number of files that can be uploaded at a time, default 5.
* TENANT_DOCUMENT_COUNT:
* TENANT\_DOCUMENT\_COUNT:
Number of files that can be uploaded per tenant, default 100.
Number of files that can be uploaded per tenant, default 100.
* ETL\_TYPE 
**Available enumeration types include:** 
* dify 
Dify's proprietary file extraction scheme 
* Unstructured 
Unstructured.io file extraction scheme 
* UNSTRUCTURED\_API\_URL 
Unstructured API path, needs to be configured when ETL\_TYPE is Unstructured. 
For example: `http://unstructured:8000/general/v0/general`
#### Multi-modal Configuration
* MULTIMODAL_SEND_IMAGE_FORMAT
* MULTIMODAL\_SEND\_IMAGE\_FORMAT
The format of the image sent when the multi-modal model is input, the default is `base64`, optional `url`.
The delay of the call in `url` mode will be lower than that in `base64` mode. It is generally recommended to use the more compatible `base64` mode.
If configured as `url`, you need to configure `FILES_URL` as an externally accessible address so that the multi-modal model can access the image.
* UPLOAD_IMAGE_FILE_SIZE_LIMIT
The format of the image sent when the multi-modal model is input, the default is `base64`, optional `url`. The delay of the call in `url` mode will be lower than that in `base64` mode. It is generally recommended to use the more compatible `base64` mode. If configured as `url`, you need to configure `FILES_URL` as an externally accessible address so that the multi-modal model can access the image.
* UPLOAD\_IMAGE\_FILE\_SIZE\_LIMIT
Upload image file size limit, default 10M.
@ -287,13 +297,13 @@ Used to store uploaded data set files, team/tenant encryption keys, and other fi
Used for application monitoring and error log tracking.
* SENTRY_DSN
* SENTRY\_DSN
Sentry DSN address, default is empty, when empty, all monitoring information is not reported to Sentry.
* SENTRY_TRACES_SAMPLE_RATE
* SENTRY\_TRACES\_SAMPLE\_RATE
The reporting ratio of Sentry events, if it is 0.01, it is 1%.
* SENTRY_PROFILES_SAMPLE_RATE
* SENTRY\_PROFILES\_SAMPLE\_RATE
The reporting ratio of Sentry profiles, if it is 0.01, it is 1%.
@ -301,18 +311,18 @@ Used for application monitoring and error log tracking.
Notion integration configuration, variables can be obtained by applying for Notion integration: [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations)
* NOTION_CLIENT_ID
* NOTION_CLIENT_SECRET
* NOTION\_CLIENT\_ID
* NOTION\_CLIENT\_SECRET
#### Mail related configuration
* MAIL_TYPE
* MAIL\_TYPE
The type of mail provider, currently only supports: resend (https://resend.com). If left empty, no mail will be sent.
* MAIL_DEFAULT_SEND_FROM
* MAIL\_DEFAULT\_SEND\_FROM
The sender's email name, such as: no-reply [no-reply@dify.ai](mailto:no-reply@dify.ai), not mandatory.
* RESEND_API_KEY
* RESEND\_API\_KEY
API-Key for the Resend email provider, can be obtained from API-Key.
@ -320,38 +330,38 @@ Notion integration configuration, variables can be obtained by applying for Noti
Only available for cloud version.
* GITHUB_CLIENT_ID: GitHub authorization login Client ID
* GITHUB_CLIENT_SECRET: GitHub authorization login Client Secret
* GOOGLE_CLIENT_ID: Google authorization login Client ID
* GOOGLE_CLIENT_SECRET: Google authorization login Client Secret
* GITHUB\_CLIENT\_ID: GitHub authorization login Client ID
* GITHUB\_CLIENT\_SECRET: GitHub authorization login Client Secret
* GOOGLE\_CLIENT\_ID: Google authorization login Client ID
* GOOGLE\_CLIENT\_SECRET: Google authorization login Client Secret
#### Platform Hosting Model Related Configuration
Only available for cloud version, used for model hosting configuration.
* HOSTED_OPENAI_ENABLED: Enable OpenAI hosted service, default False
* HOSTED_OPENAI_API_KEY: OpenAI hosted service API key
* HOSTED_OPENAI_API_BASE: OpenAI hosted service API base URL, default is empty, i.e. `https://api.openai.com/v1`
* HOSTED_OPENAI_API_ORGANIZATION: OpenAI hosted service organization ID, default is empty
* HOSTED_OPENAI_QUOTA_LIMIT: OpenAI hosted service default trial quota (unit: call count), default 200 calls
* HOSTED_OPENAI_PAID_ENABLED: Enable OpenAI hosted paid service, default False
* HOSTED_OPENAI_PAID_STRIPE_PRICE_ID: OpenAI hosted paid service Stripe price ID
* HOSTED_OPENAI_PAID_INCREASE_QUOTA: Increase quota amount after payment for OpenAI hosted paid service
* HOSTED_AZURE_OPENAI_ENABLED: Enable Azure OpenAI hosted service, default False
* HOSTED_AZURE_OPENAI_API_KEY: Azure OpenAI hosted service API key
* HOSTED_AZURE_OPENAI_API_BASE: Azure OpenAI hosted service API base URL
* HOSTED_AZURE_OPENAI_QUOTA_LIMIT: Azure OpenAI hosted service default trial quota (unit: call count)
* HOSTED_ANTHROPIC_ENABLED: Enable Anthropic hosted service, default False
* HOSTED_ANTHROPIC_API_BASE: Anthropic hosted service API base URL, default is empty
* HOSTED_ANTHROPIC_API_KEY: Anthropic hosted service API key
* HOSTED_ANTHROPIC_QUOTA_LIMIT: Anthropic hosted service default trial quota (unit: tokens), default 600,000 tokens
* HOSTED_ANTHROPIC_PAID_ENABLED: Enable Anthropic hosted paid service, default False
* HOSTED_ANTHROPIC_PAID_STRIPE_PRICE_ID: Anthropic hosted paid service Stripe price ID
* HOSTED_ANTHROPIC_PAID_INCREASE_QUOTA: Increase quota amount for Anthropic hosted paid service
* HOSTED_ANTHROPIC_PAID_MIN_QUANTITY: Minimum purchase quantity for Anthropic hosted paid service
* HOSTED_ANTHROPIC_PAID_MAX_QUANTITY: Maximum purchase quantity for Anthropic hosted paid service
* STRIPE_API_KEY: Stripe's API key
* STRIPE_WEBHOOK_SECRET: Stripe's Webhook secret
* HOSTED\_OPENAI\_API\_KEY: OpenAI hosted service API key
* HOSTED\_OPENAI\_API\_BASE: OpenAI hosted service API base URL, default is empty, i.e. `https://api.openai.com/v1`
* HOSTED\_OPENAI\_API\_ORGANIZATION: OpenAI hosted service organization ID, default is empty
* HOSTED\_OPENAI\_TRIAL\_ENABLED: Enable OpenAI hosted trial service, default False
* HOSTED\_OPENAI\_QUOTA\_LIMIT: OpenAI hosted service default trial quota (unit: call count), default 200 calls
* HOSTED\_OPENAI\_PAID\_ENABLED: Enable OpenAI hosted paid service, default False
* HOSTED\_OPENAI\_PAID\_STRIPE\_PRICE\_ID: OpenAI hosted paid service Stripe price ID
* HOSTED\_OPENAI\_PAID\_INCREASE\_QUOTA: Increase quota amount after payment for OpenAI hosted paid service
* HOSTED\_AZURE\_OPENAI\_ENABLED: Enable Azure OpenAI hosted service, default False
* HOSTED\_AZURE\_OPENAI\_API\_KEY: Azure OpenAI hosted service API key
* HOSTED\_AZURE\_OPENAI\_API\_BASE: Azure OpenAI hosted service API base URL
* HOSTED\_AZURE\_OPENAI\_QUOTA\_LIMIT: Azure OpenAI hosted service default trial quota (unit: call count)
* HOSTED\_ANTHROPIC\_API\_BASE: Anthropic hosted service API base URL, default is empty
* HOSTED\_ANTHROPIC\_API\_KEY: Anthropic hosted service API key
* HOSTED\_ANTHROPIC\_TRIAL\_ENABLED: Enable Anthropic hosted trial service, default False
* HOSTED\_ANTHROPIC\_QUOTA\_LIMIT: Anthropic hosted service default trial quota (unit: tokens), default 600,000 tokens
* HOSTED\_ANTHROPIC\_PAID\_ENABLED: Enable Anthropic hosted paid service, default False
* HOSTED\_ANTHROPIC\_PAID\_STRIPE\_PRICE\_ID: Anthropic hosted paid service Stripe price ID
* HOSTED\_ANTHROPIC\_PAID\_INCREASE\_QUOTA: Increase quota amount for Anthropic hosted paid service
* HOSTED\_ANTHROPIC\_PAID\_MIN\_QUANTITY: Minimum purchase quantity for Anthropic hosted paid service
* HOSTED\_ANTHROPIC\_PAID\_MAX\_QUANTITY: Maximum purchase quantity for Anthropic hosted paid service
* STRIPE\_API\_KEY: Stripe's API key
* STRIPE\_WEBHOOK\_SECRET: Stripe's Webhook secret
#### Others
@ -361,34 +371,33 @@ Only available for cloud version, used for model hosting configuration.
### Web Frontend
#### SENTRY_DSN
#### SENTRY\_DSN
Sentry DSN address, default is empty, when empty, all monitoring information is not reported to Sentry.
## Deprecated
#### CONSOLE\_URL
>⚠️ Modified in 0.3.8, will be deprecated in 0.4.0, replaced by: `CONSOLE_API_URL` and `CONSOLE_WEB_URL`.
> ⚠️ Modified in 0.3.8, will be deprecated in 0.4.9, replaced by: `CONSOLE_API_URL` and `CONSOLE_WEB_URL`.
Console URL, used to concatenate the authorization callback, console front-end address, and CORS configuration use. If empty, it is the same domain. Example: `https://console.dify.ai`.
#### API\_URL
>⚠️ Modified in 0.3.8, will be deprecated in 0.4.0, replaced by `SERVICE_API_URL`.
> ⚠️ Modified in 0.3.8, will be deprecated in 0.4.9, replaced by `SERVICE_API_URL`.
API URL, used to display Service API Base URL to the front-end. If empty, it is the same domain. Example: `https://api.dify.ai`
#### APP\_URL
>⚠️ Modified in 0.3.8, will be deprecated in 0.4.0, replaced by `APP_API_URL` and `APP_WEB_URL`.
> ⚠️ Modified in 0.3.8, will be deprecated in 0.4.9, replaced by `APP_API_URL` and `APP_WEB_URL`.
WebApp Url, used to display WebAPP API Base Url to the front-end. If empty, it is the same domain. Example: `https://api.app.dify.ai`
#### Session Configuration
>⚠️ This configuration is no longer valid since v0.3.24, will be deprecated in 0.4.0.
> ⚠️ This configuration is no longer valid since v0.3.24.
Only used by the API service for interface identity verification.
@ -398,11 +407,10 @@ Only used by the API service for interface identity verification.
* redis (default)
If you choose this, you need to set the environment variables starting with SESSION_REDIS_ below.
If you choose this, you need to set the environment variables starting with SESSION\_REDIS\_ below.
* sqlalchemy
If you choose this, the current database connection will be used and the sessions table will be used to read and write session records.
* SESSION\_REDIS\_HOST: Redis host
* SESSION\_REDIS\_PORT: Redis port, default is 6379
* SESSION\_REDIS\_DB: Redis Database, default is 0. Please use a different Database from Redis and Celery Broker.
@ -412,16 +420,16 @@ Only used by the API service for interface identity verification.
#### Cookie Policy Configuration
>⚠️ This configuration is no longer valid since v0.3.24, will be deprecated in 0.4.0.
> ⚠️ This configuration is no longer valid since v0.3.24.
Used to set the browser policy for session cookies used for identity verification.
* COOKIE\_HTTPONLY
Cookie HttpOnly configuration, default is true.
* COOKIE\_SAMESITE
* COOKIE\_SAMESITE
Cookie SameSite configuration, default is Lax.
* COOKIE\_SECURE
* COOKIE\_SECURE
Cookie Secure configuration, default is false.