seafile-admin-docs/manual/config
Huang Junxiang bfea181164
Merge 12.0 to 13.0 (#513)
* Add changelog for 12.0.10

* Add changelog for 12.0.10

* fix: migrate from non-docker

* fix: minimal install for mariadb in backup and recover

* fix: fuse content missing in host

* opt:adjusting migration strategy

* Add changelog for pro 12.0.10

* Update security_features.md

Update descriptions for encrypted library.

* Update seahub_settings_py.md

Update description for encrypted library versions.

* docs: update Windows development setup instructions for vcpkg (#471)

* Update drive-client-changelog.md

3.0.13

* update seasearch.yml

* update

* Update shibboleth_authentication.md

* Update remote_user.md

* fix: backup & restore command mysql -> mariadb

* update backup and recovery commands and tip

* opt: steps in recovering DB

* update link of note of MDEV-30203 note from Mariadb

* update link of note of MDEV-30203 note from Mariadb

* opt: steps in recovering DB

* Add changelog for 12.0.11-pro

* Add changelog for v12.0.11

* fix: ce binary deployment format error

* Update changelog-for-seafile-professional-server.md

* feat: helm support custom storageClassName (#486)

* docs(onlyoffice): syntax error (#489)

* Custom set user role when shib login (#493)

Co-authored-by: lian <imwhatiam123@gmail.com>

* Seahub customizing opt (#499)

* update

* Update seahub_customization.md

* Update client-changelog.md

9.0.13

* Update upgrade_notes_for_12.0.x.md (#501)

* Update upgrade_notes_for_12.0.x.md

* Update upgrade_notes_for_12.0.x.md

---------

Co-authored-by: Daniel Pan <freeplant@gmail.com>

* Update upgrade_docker.md

* update upgrade to 12.0: other configuration changes (#502)

* Update changelog-for-seafile-professional-server.md

* Update sending_email.md (#512)

* Update sending_email.md

* Update sending_email.md

---------

Co-authored-by: Daniel Pan <daniel.pan@seafile.com>
Co-authored-by: Daniel Pan <freeplant@gmail.com>
Co-authored-by: Jiaqiang Xu <jonathan.xu@seafile.com>
Co-authored-by: rumtid <liwei.jiang@seafile.com>
Co-authored-by: r350178982 <32759763+r350178982@users.noreply.github.com>
Co-authored-by: lian <imwhatiam123@gmail.com>
Co-authored-by: seafile-dev <57566977+seafile-dev@users.noreply.github.com>
2025-04-27 11:33:12 +08:00
..
README.md update 12.0 ce from binary 2024-12-18 17:00:38 +08:00
admin_roles_permissions.md opt:leave first-level-dirs 2024-10-23 10:02:34 +08:00
auth_switch.md feat: add tabs and notes 2024-10-29 15:13:29 +08:00
auto_login_seadrive.md feat: add tabs and notes 2024-10-29 15:13:29 +08:00
ccnet-conf.md Update 12.0 cluster deployments && init conf files 2024-11-09 11:44:42 +08:00
config_seafile_with_ADFS.md opt:leave first-level-dirs 2024-10-23 10:02:34 +08:00
customize_email_notifications.md opt:leave first-level-dirs 2024-10-23 10:02:34 +08:00
details_about_file_search.md Update document on details_about_file_search 2024-11-12 14:57:05 +08:00
env.md update configuring for S3 and notification server (#509) 2025-04-25 11:16:31 +08:00
ldap_in_11.0_ce.md feat: add tabs and notes 2024-10-29 15:13:29 +08:00
ldap_in_11.0_pro.md 13.0 republish (#479) 2025-03-19 19:49:57 +08:00
multi_institutions.md Improve document on multi-institution 2024-11-12 14:45:43 +08:00
multi_tenancy.md Update document on multi-tenancy 2024-11-12 15:29:49 +08:00
oauth.md Improve document on oauth 2024-11-12 14:41:46 +08:00
ocm.md opt: some tabs contents 2024-10-29 18:23:56 +08:00
remote_user.md 13.0 republish (#479) 2025-03-19 19:49:57 +08:00
roles_permissions.md Add role permission can_create_wiki and can_publish_wiki 2024-12-19 15:12:42 +08:00
saml2_in_10.0.md opt: some tabs contents 2024-10-29 18:23:56 +08:00
seafevents-conf.md feat: metadata server 2025-02-23 14:21:18 +08:00
seafile-conf.md Merge branch 'master' into 13.0 2025-02-25 10:56:42 +08:00
seahub_customization.md Merge 12.0 to 13.0 (#513) 2025-04-27 11:33:12 +08:00
seahub_settings_py.md 13.0 republish (#479) 2025-03-19 19:49:57 +08:00
sending_email.md Merge 12.0 to 13.0 (#513) 2025-04-27 11:33:12 +08:00
shibboleth_authentication.md Merge 12.0 to 13.0 (#513) 2025-04-27 11:33:12 +08:00
single_sign_on.md opt:leave first-level-dirs 2024-10-23 10:02:34 +08:00

Server Configuration and Customization

Config Files

The config files used in Seafile include:

  • environment variables: contains environment variables, the items here are shared between different components. Newly introduced components, like sdoc-server and notificaiton server, read configuraitons from environment variables and have no config files.
  • seafile.conf: contains settings for seafile daemon and fileserver.
  • seahub_settings.py: contains settings for Seahub
  • seafevents.conf: contains settings for background tasks and file search.

You can also modify most of the config items via web interface.The config items are saved in database table (seahub-db/constance_config). They have a higher priority over the items in config files.

Seafile Config via Web

The design of configure options

There are now three places you can config Seafile server:

  • environment variables
  • config files
  • via web interface

The web interface has the highest priority. It contains a subset of end-user oriented settings. In practise, you can disable settings via web interface for simplicity.

Environment variables contains system level settings that needed when initialize Seafile server or run Seafile server. Environment variables also have three categories:

  • Initialization variables that used to generate config files when Seafile server run for the first time.
  • Variables that shared and used by multiple components of Seafile server.
  • Variables that used both in generate config files and later also needed for some components that have no corresponding config files.

The variables in the first category can be deleted after initialization. In the future, we will make more components to read config from environment variables, so that the third category is no longer needed.