Skip to main content

WebDAV and S3 server

WebDAV server​

You can use the Filen CLI to start a WebDAV server that acts as a mirror server of your Filen Drive.

For technical information, see also FilenCloudDienste/filen-webdav on GitHub.

Single user​

$ filen webdav --w-user <...> --w-password <...> [options...]

Invoke filen webdav to start a local WebDAV server that mirrors your personal Filen Drive. This might be useful for allowing local applications to access your Filen Drive via WebDAV.

You must specify login credentials for connecting to the server using the --w-user and --w-password options (these credentials should be different from your Filen account credentials).

Options:

  • --w-https: run the server on HTTPS instead of HTTP (using a self-signed certificate)
  • --w-hostname: which hostname the server should be started on (default is 0.0.0.0)
  • --w-port: which port the server should be started on (default is 80 or 443)
  • --w-auth-scheme: the authentication scheme the server should use, "basic" or "digest" (default is basic)
  • --w-threads: enables clustering, number of threads to use for the server (default is no clustering; explicitly set to 0 to set by CPU core count). If you experience rate-limiting using this, using an auth config might help.

Proxy mode​

$ filen webdav-proxy [options...]

Invoke the filen webdav-proxy to start a WebDAV server that allows any user to connect using their Filen account credentials and access their own Filen Drive. This might be useful when hosting a proxy server for multiple users. Digest auth is not available for proxy mode.

Important: In proxy mode, the password has to be formatted as password=yoursecretpassword&twoFactorAuthentication=<RECOVERY_CODE_OR_6_DIGIT_OTP_CODE> (you can also leave out the &twoFactorAuthentication=... part if 2FA is disabled for your account).

Options: --w-https, --w-hostname, --w-port, --w-threads as above

S3 server​

$ filen s3 --s3-access-key-id <...> --s3-secret-access-key <...> [options...]

Invoke filen s3 to start an S3 server that acts as a mirror server of your Filen Drive. You must specify credentials (Access Key ID and Secret Access Key) for connecting to the server using the --s3-access-key-id and --s3-secret-access-key options (these credentials should be different from your Filen account credentials).

Important: When connecting to the S3 server, you need to enable s3ForcePathStyle and set the region to filen.

For more information, including on S3 compatibility, see also FilenCloudDienste/filen-s3 on GitHub.

Options:

  • --s3-https: run the server on HTTPS instead of HTTP (using a self-signed certificate)
  • --s3-hostname: which hostname the server should be started on (default is 0.0.0.0)
  • --s3-port: which port the server should be started on (default is 80 or 443)
  • --s3-threads: enables clustering, number of threads to use for the server (default is no clustering; explicitly set to 0 to set by CPU core count). If you experience rate-limiting using this, using an auth config might help.