- Preconfigure Seafile Clients
- How to use run Seafile client as a service on Windows
- How to suppress the launch of Seafile client after install on Windows
- How to solve the shell icon overlay not shown problem
Normally, when the user installs a fresh seafile client, a login dialog would prompt him/her to fill the server address and user credentials. These behavior can be preconfigured by IT admins so that the users don't need to do it themselves.
There are two ways to preconfigure seafile client:
- On windows, the admin can store the details it in the windows registry.
- On all desktop platforms (win/linux/mac), the admin can also store the details in a file
seafile.iniin the HOME folder of the user.
The preconfigure information can be stored in one of the following two places:
If the information is found in both places, the one under
HKEY_CURRENT_USER would take precedence.
Special Note for 64bit Windows Deployment
If you are using 64-bit windows and using HKLM instead of HKCU to deploy your seafile program. please note you need to correct the PrimaryKey to
HKEY_LOCAL_MACHINE\\SOFTWARE\\Seafile. This is because seafile client is compiled as a 32-bit application on windows.
To preset the default server address:
- Key: PreconfigureServerAddr - Type: REG_SZ - Value: <url to the seafile server address>
To preset the default shibboleth login address:
- Key: PreconfigureShibbolethLoginUrl - Type: REG_SZ - Value: <the shibboleth login url>, e.g https://example.seafile.com/shib-login
To preset the account and login token:
- Key: PreconfigureUsername - Type: REG_SZ - Value: <The Username or Email>
- Key: PreconfigureUserToken - Type: REG_SZ - Value: <the Seahub access token> (You can get the token via Web API)
To prevent the user from using any other Seafile server:
- Key: PreconfigureServerAddrOnly - Type: REG_SZ - Value: 1 (stands for enable) or 0 (stands for disable) - Effect: The user can't use any other Seafile server.
To preset the location of Seafile folder:
- Key: PreconfigureDirectory - Type: REG_SZ - Value: <absolute path to the Seafile folder>
To avoid the configuration wizard:
- Key: HideConfigurationWizard - Type: REG_SZ - Value: 0 (show configuration wizard) or 1 (hide configuration wizard) - Effect: If you run seafile first time or without any account, seafile will look up this configure and hide configure wizard accordingly.
To disable the "Do you want to remove the account information" dialog when uninstalling seafile client on Windows:
- Key: PreconfigureKeepConfigWhenUninstall - Type: REG_SZ - Value: 0 (show the confirm dialog) or 1 (hide the confirm dialog wizard)
This feature is available in seafile client 4.3.0 and above.
Below is an example to preset server address, user, token and Seafile folder:
[preconfigure] PreconfigureDirectory = ~/ PreconfigureUsername = firstname.lastname@example.org PreconfigureUserToken = t0Ken PreconfigureServerAddr = https://cloud.seafile.de
Seafile client can be configured to run as a daemon using tools like Firedaemon. First configure Seafile as the user it should run - in this example "Administator"：
Parameters for ccnet: -c C:/Users/Administrator/ccnet Parameters for seaf-daemon: -c C:/Users/Administrator/ccnet -d S:/seafile-data -w S:/Seafile
S: with the partition you actually use to store
You call also use tools like NSSM (the Non-Sucking Service Manager). For more information, please check https://valdasv.blogspot.jp/2016/06/seafile-client-service.html
When the user installs seafile client on windows, the seafile client program would be started immediately after the installation is finished.
While this is the expected action for most users, it may be necessary to disable it sometimes. For example, when the seafile client is installed with Windows Group Policy Object (GPO), the program would be launched with the ADMIN user (instead of the current login user), which would make the program work incorrectly. In such cases, it's desirable to disable the launch of seafile client after installtion.
To disable this behavior:
- Key: PreconfigureSuppressLaunchAfterInstall - Type: REG_SZ - Value: 1
Windows uses only the first 15 of the entries in the registry (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers). If there are other programs, like Dropbox and OneDrive, use up the overlay icons, Seafile shell icon overlay will not shown. To solve the problem, just delete the registration entries of other programs.