Seahub customization

Customize Seahub Logo and CSS

Create customize folder

=== "Deploy in Docker" sh mkdir -p /opt/seafile-data/seafile/seahub-data/custom === "Deploy from binary packages" sh mkdir /opt/seafile/seafile-server-latest/seahub/media/custom

During upgrading, Seafile upgrade script will create symbolic link automatically to preserve your customization.

Customize Logo

Add your logo file to custom/

Overwrite LOGO_PATH in seahub_settings.py

LOGO_PATH = 'custom/mylogo.png'

Default width and height for logo is 149px and 32px, you may need to change that according to yours.

LOGO_WIDTH = 149
LOGO_HEIGHT = 32

Customize Favicon

Add your favicon file to custom/

Overwrite FAVICON_PATH in seahub_settings.py

FAVICON_PATH = 'custom/favicon.png'

Customize Seahub CSS

Add your css file to custom/, for example, custom.css

Overwrite BRANDING_CSS in seahub_settings.py

BRANDING_CSS = 'custom/custom.css'

Customize help page

=== "Deploy in Docker" sh mkdir -p /opt/seafile-data/seafile/seahub-data/custom/templates/help/ cd /opt/seafile-data/seafile/seahub-data/custom cp ../../help/templates/help/install.html templates/help/ === "Deploy from binary packages" sh mkdir /opt/seafile/seafile-server-latest/seahub/media/custom/templates/help/ cd /opt/seafile/seafile-server-latest/seahub/media/custom cp ../../help/templates/help/base.html templates/help/

For example, modify the templates/help/install.html file and save it. You will see the new help page.

!!! note There are some more help pages available for modifying, you can find the list of the html file here

You can add an extra note in sharing dialog in seahub_settings.py

ADDITIONAL_SHARE_DIALOG_NOTE = {
    'title': 'Attention! Read before shareing files:',
    'content': 'Do not share personal or confidential official data with **.'
}

Result:

Since Pro 7.0.9, Seafile supports adding some custom navigation entries to the home page for quick access. This requires you to add the following configuration information to the conf/seahub_settings.py configuration file:

CUSTOM_NAV_ITEMS = [
    {'icon': 'sf2-icon-star',
     'desc': 'Custom navigation 1',
     'link': 'https://www.seafile.com'
    },
    {'icon': 'sf2-icon-wiki-view',
     'desc': 'Custom navigation 2',
     'link': 'https://www.seafile.com/help'
    },
    {'icon': 'sf2-icon-wrench',
     'desc': 'Custom navigation 3',
     'link': 'http://www.example.com'
    },
]

!!! note The icon field currently only supports icons in Seafile that begin with sf2-icon. You can find the list of icons here

Then restart the Seahub service to take effect.

Once you log in to the Seafile system homepage again, you will see the new navigation entry under the Tools navigation bar on the left.

Add more links to about dialog

ADDITIONAL_ABOUT_DIALOG_LINKS = {
    'seafile': 'https://example.seahub.com/seahub',
    'dtable-web': 'https://example.seahub.com/dtable-web'
}

Result:

3.4 KiB Raw Blame History