15308555518/ seafile-admin-docs
1
0
Fork 0
mirror of https://github.com/haiwen/seafile-admin-docs.git synced 2025-12-26 02:32:50 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
seafile-admin-docs/manual/config/env.md
Huang Junxiang 7a9cbd01a6
perf: Optimize the deployment process and improve user experience (#492) 
* perf: Optimize the deployment process and improve user experience

* revert: SEAFILE_S3_ -> INIT_S3_

* fix(seafile-server.yml): default value for INIT_S3_HOST

* docs: add descriptions for new env

* adjust deployment documentation
2025-03-27 11:24:33 +08:00

7.4 KiB
Raw Blame History

.env

The .env file will be used to specify the components used by the Seafile-docker instance and the environment variables required by each component.

Seafile-docker configurations

Components configurations

  • COMPOSE_FILE: .yml files for components of Seafile-docker, each .yml must be separated by the symbol defined in COMPOSE_PATH_SEPARATOR. The core components are involved in seafile-server.yml and caddy.yml which must be taken in this term.
  • COMPOSE_PATH_SEPARATOR: The symbol used to separate the .yml files in term COMPOSE_FILE, default is ','.

Docker images configurations

  • SEAFILE_IMAGE: The image of Seafile-server, default is seafileltd/seafile-pro-mc:12.0-latest.
  • SEAFILE_DB_IMAGE: Database server image, default is mariadb:10.11.
  • SEAFILE_MEMCACHED_IMAGE: Cached server image, default is memcached:1.6.29
  • SEAFILE_ELASTICSEARCH_IMAGE: Only valid in pro edition. The elasticsearch image, default is elasticsearch:8.15.0.
  • SEAFILE_CADDY_IMAGE: Caddy server image, default is lucaslorentz/caddy-docker-proxy:2.9-alpine.
  • SEADOC_IMAGE: Only valid after integrating SeaDoc. SeaDoc server image, default is seafileltd/sdoc-server:1.0-latest.

Persistent Volume Configurations

  • SEAFILE_VOLUME: The volume directory of Seafile data, default is /opt/seafile-data.
  • SEAFILE_MYSQL_VOLUME: The volume directory of MySQL data, default is /opt/seafile-mysql/db.
  • SEAFILE_CADDY_VOLUME: The volume directory of Caddy data used to store certificates obtained from Let's Encrypt's, default is /opt/seafile-caddy.
  • SEAFILE_ELASTICSEARCH_VOLUME: Only valid in pro edition. The volume directory of Elasticsearch data, default is /opt/seafile-elasticsearch/data.
  • SEADOC_VOLUME: Only valid after integrating SeaDoc. The volume directory of SeaDoc server data, default is /opt/seadoc-data.

MySQL configurations

  • SEAFILE_MYSQL_DB_HOST: The host address of Mysql, default is the pre-defined service name db in Seafile-docker instance.
  • INIT_SEAFILE_MYSQL_ROOT_PASSWORD: (Only required on first deployment) The root password of MySQL.
  • SEAFILE_MYSQL_DB_USER: The user of MySQL (database - user can be found in conf/seafile.conf).
  • SEAFILE_MYSQL_DB_PASSWORD: The user seafile password of MySQL.
  • SEAFILE_MYSQL_DB_SEAFILE_DB_NAME: The name of Seafile database name, default is seafile_db
  • SEAFILE_MYSQL_DB_CCNET_DB_NAME: The name of ccnet database name, default is ccnet_db
  • SEAFILE_MYSQL_DB_SEAHUB_DB_NAME: The name of seahub database name, default is seahub_db

Cache configurations

  • CACHE_PROVIDER: The type of cache server used for Seafile. The available options are redis and memcached. Since Seafile 13, it is recommended to use redis as the cache service to support new features, and memcached will no longer be integrated into Seafile Docker by default. Default is redis

Redis configurations

This part of configurations is only valid in CACHE_PROVIDER=redis

  • REDIS_SERVER: Redis server host, default is redis
  • REDIS_PORT: Redis server port, default is 6379
  • REDIS_PASSWORD: Redis server password. You need to uncheck the mark of the command part of the redis service in seafile-server.yml to enable this feature if you are using the integrated Redis server in Seafile Docker.

Redis configurations

This part of configurations is only valid in CACHE_PROVIDER=memcached

  • MEMCACHED_SERVER: Memcached server host, default is memcached
  • MEMCACHED_PORT: Memcached server port, default is 11211

Seafile-server configurations

  • JWT_PRIVATE_KEY: JWT_PRIVATE_KEY, A random string with a length of no less than 32 characters, generate example: pwgen -s 40 1
  • SEAFILE_SERVER_HOSTNAME: Seafile server hostname or domain
  • SEAFILE_SERVER_PROTOCOL: Seafile server protocol (http or https)
  • TIME_ZONE: Time zone (default UTC)
  • INIT_SEAFILE_ADMIN_EMAIL: Admin username
  • INIT_SEAFILE_ADMIN_PASSWORD: Admin password

SeaDoc configurations (only valid after integrating SeaDoc)

Cluster init configuration

  • CLUSTER_INIT_MODE: (only valid in pro edition at deploying first time). Cluster initialization mode, in which the necessary configuration files for the service to run will be generated (but the service will not be started). If the configuration file already exists, no operation will be performed. The default value is true. When the configuration file is generated, be sure to set this item to false.
  • CLUSTER_INIT_MEMCACHED_HOST: (only valid in pro edition at deploying first time). Cluster Memcached host. (If your Memcached server dose not use port 11211, please modify the seahub_settings.py and seafile.conf).
  • CLUSTER_INIT_ES_HOST: (only valid in pro edition at deploying first time). Your cluster Elasticsearch server host.
  • CLUSTER_INIT_ES_PORT: (only valid in pro edition at deploying first time). Your cluster Elasticsearch server port. Default is 9200.
  • CLUSTER_MODE: Seafile service node type, i.e., frontend (default) or backend

S3 storage backend configurations (only valid in pro edition at deploying first time)

  • INIT_S3_STORAGE_BACKEND_CONFIG: Whether to configure S3 storage backend synchronously during initialization (i.e., the following features in this section, for more details, please refer to AWS S3), default is false.
  • INIT_S3_COMMIT_BUCKET: S3 storage backend fs objects bucket
  • INIT_S3_FS_BUCKET: S3 storage backend block objects bucket
  • INIT_S3_BLOCK_BUCKET: S3 storage backend block objects bucket
  • INIT_S3_KEY_ID: S3 storage backend key ID
  • INIT_S3_SECRET_KEY: S3 storage backend secret key
  • INIT_S3_USE_V4_SIGNATURE: Use the v4 protocol of S3 if enabled, default is true
  • INIT_S3_AWS_REGION: Region of your buckets (AWS only), default is us-east-1. (Only valid when INIT_S3_USE_V4_SIGNATURE sets to true)
  • INIT_S3_HOST: Host of your buckets, default is s3.us-east-1.amazonaws.com. (Only valid when INIT_S3_USE_V4_SIGNATURE sets to true)
  • INIT_S3_USE_HTTPS: Use HTTPS connections to S3 if enabled, default is true
  • INIT_S3_PATH_STYLE_REQUEST: This option asks Seafile to use URLs like https://192.168.1.123:8080/bucketname/object to access objects. In Amazon S3, the default URL format is in virtual host style, such as https://bucketname.s3.amazonaws.com/object. But this style relies on advanced DNS server setup. So most self-hosted storage systems only implement the path style format. Default true.
  • INIT_S3_SSE_C_KEY: A string of 32 characters can be generated by openssl rand -base64 24. It can be any 32-character long random string. It's required to use V4 authentication protocol and https if you enable SSE-C.

SeaSearch

For configurations about SeaSearch in .env, please refer here for the details.

Metadata server

For configurations about Metadata server in .env, please refer here for the details.