seafile-admin-docs/manual/config/multi_institutions.md
Huang Junxiang 2d2169d2a6
Some checks are pending
Deploy CI - 13.0 / deploy (push) Waiting to run
Merge 12.0 to 13.0 (#543)
* 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

* perf: Priority issues for S3_HOST and S3_AWS_REGION in 12.0

* perf: Priority issues for S3_HOST and S3_AWS_REGION in 12.0

* Update sending_email.md (#512)

* Update sending_email.md

* Update sending_email.md

* Update drive-client-changelog.md

3.0.14

* Update drive-client-changelog.md

3.0.14

* code bar copy button (#517)

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

* 12.0 index master (#518)

* add index-server

* deploy index-server

* deploy index-server

* rm redis in env

* Update distributed_indexing.md

* update restore-all-repo command

---------

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

* wget index-server.yml

* update index-server conf

* update index-worker.conf

* SeaDoc standalone Apache proxy (#519)

* fix: typo error serve -> server (#522)

* update 12.0 seasearch default image (#523)

* fix: use nginx to proxy onlyoffice (#525)

* fix: cluster by docker for es_host in init

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

* Update server-changelog.md

* add usage of custom ca certificate with caddy (#530)

* Update multi_institutions.md

* Update client-changelog.md

9.0.14

* update old sdoc tag

* Add fs_id_list_max_threads option (#538)

Co-authored-by: yangheran <heran.yang@seafile.com>

* Update drive-client-changelog.md

3.0.15

* remove ce binary after merge

---------

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>
Co-authored-by: 欢乐马 <38058090+SkywalkerSpace@users.noreply.github.com>
Co-authored-by: skywalker <dzmbbs@qq.com>
Co-authored-by: feiniks <36756310+feiniks@users.noreply.github.com>
Co-authored-by: yangheran <heran.yang@seafile.com>
2025-06-27 14:39:49 +08:00

1.4 KiB

Multiple Organization/Institution User Management

Starting from version 5.1, you can add institutions into Seafile and assign users into institutions. Each institution can have one or more administrators. This feature is to ease user administration when multiple organizations (universities) share a single Seafile instance. Unlike multi-tenancy, the users are not-isolated. A user from one institution can share files with another institution.

Turn on the feature

In seahub_settings.py, add MULTI_INSTITUTION = True to enable multi-institution feature, and add

    EXTRA_MIDDLEWARE += (
        'seahub.institutions.middleware.InstitutionMiddleware',
    )

!!! tip "Please replease += to = if EXTRA_MIDDLEWARE is not defined"

Add institutions and institution admins

After restarting Seafile, a system admin can add institutions by adding institution name in admin panel. He can also click into an institution, which will list all users whose profile.institution match the name.

Assign users to institutions

If you are using Shibboleth, you can map a Shibboleth attribute into institution. For example, the following configuration maps organization attribute to institution.

SHIBBOLETH_ATTRIBUTE_MAP = {
    "givenname": (False, "givenname"),
    "sn": (False, "surname"),
    "mail": (False, "contact_email"),
    "organization": (False, "institution"),
}