Configuring Weavy

Many features in Weavy can be enabled, disabled and/or modified via configuration settings. These settings are usually stored in an appsettings.json file but depending on your environment other configuration providers are also available.

Database connection string

The ConnectionStrings section must be configured with a connection string to the Weavy database as shown in the example below:

"ConnectionStrings": {
  "Weavy": "server=localhost;database=weavy;trusted_connection=true;"
}

For more information about connection string syntax see: SQL Server 2019 connection strings

Weavy settings

The Weavy configuration section can be configured with the following settings:

* If you want to allow files larger than 30 MB you also need to configure MaxRequestBodySize for Kestrel (the default web server for ASP.NET Core). By default it is set to 30000000 bytes (approximately 28.6MB). Additionally, if you are running Weavy behind IIS you also need to configure the maxAllowedContentLength attribute in the web.config file.

"Kestrel": {
    "Limits": {
      "MaxRequestBodySize": 134217728
    }
}    

<requestLimits maxAllowedContentLength="134217728" />

Plugins

Many built-in features in Weavy are implemented in the form of plugins. To configure a plugin, you should add an entry in the Weavy:Plugins section with the Type property set to the assembly qualified name of the plugin. Configuration values for the plugin can then be specified as in the example below:

"Weavy": {
  "Plugins": [{
    "Type": "Weavy.Core.Plugins.CleanupDaemon, Weavy.Core",
    "Trash": false
  }]
}

Blob providers

Blob providers are plugins that control where uploaded files are stored. By default Weavy uses the SqlServerBlobProvider which stores blobs in the Weavy database, but by configuring one of the other blob providers you can tell Weavy to store files in an Azure Storage account or on disk instead of the database.

Weavy.Core.Plugins.SqlServerBlobProvider, Weavy.Core

The default blob provider which stores blobs in the Weavy database. Has no configuration settings.

Weavy.Core.Plugins.AzureBlobProvider, Weavy.Core

A provider that stores uploaded files in an Azure Storage account. This is the recommended provider to use when deploying Weavy to Microsoft Azure.

Weavy.Core.Plugins.DiskBlobProvider, Weavy.Core

A provider that stores blobs on local disk.

Hooks

Hooks are plugins that performs some action in reaction to an event in Weavy (for instance a file being uploaded).

Weavy.Core.Plugins.BlobHook, Weavy.Core

A hook that creates thumbnails and extracts text for fulltext indexing.

Daemons

Daemons are plugins configured to execute their code on a schedule defined by a cron expression. If you want to change the default schedule of a daemon you can configure the Schedule property. You can also disable a daemon by setting the Schedule to an empty string "".

Weavy.Core.Plugins.CleanupDaemon, Weavy.Core

Performs various cleanup tasks such as removing temp files etc.

Weavy.Core.Plugins.IdentityProviderDaemon, Weavy.Core

Periodically updates identity providers to support multiple and rotating signing keys.

Weavy.Core.Plugins.IndexDaemon, Weavy.Core

Updates the fulltext index with entities modified or added since the last indexing operation.

Weavy.Core.Plugins.LicenseDaemon, Weavy.Core

Refreshes license data from the license server.

Weavy.Core.Plugins.MessageDaemon, Weavy.Core

A daemon that sends emails about unread conversations and messages.

Weavy.Core.Plugins.PresenceDaemon, Weavy.Core

Keeps track of the online status of users.

Weavy.Core.Plugins.StatisticsDaemon, Weavy.Core

Creates data points for displaying usage statistics.

Weavy.Core.Plugins.ZoomProxyDaemon, Weavy.Core

Polls the Zoom proxy server for updates in meetings.

Features and integrations

Weavy also includes some optional features and integrations with 3rd party services that require additional configuration. The articles below have instructions on how to enable and configure them.

• File browser
• Teams integration
• Zoom integration

Example

A complete appsetting.json file could look something like this:

"ConnectionStrings": {
  "Weavy": "server=localhost;database=weavy;trusted_connection=true;"
},
"Kestrel": {
  "AddServerHeader": false,
  "Limits": {
    "MaxRequestBodySize": 134217728
  }
},
"Weavy": {
    "ApplicationName": "Weavy",
    "ApplicationUrl": "https://weavy-app.com",
    "AllowedOrigins": "https://myapp.com;https://another-app.com",
    "MultipartBodyLengthLimit": 134217728,
    "IdentityProviders": [
      {
        "Issuer": "my-app",
        "Secret": "MCaQXlgtfn"
      }
    ],
    "Clients": [
      {
        "Id": "api-connect",
        "Secret": "wM0B7cK5U7"
      }
    ],
    "License": "AAAAA-BBBBB-CCCCC-DDDDD",
    "LogLevel": "Debug",
    "Smtp": {
      "Server": "localhost",
      "From": "info@weavy.test"
    },
    "Plugins": [
      {
        "Type": "Weavy.Core.Plugins.StatisticsDaemon, Weavy.Core",
        "Schedule": ""
      },
      {
        "Type": "Weavy.Core.Plugins.CleanupDaemon, Weavy.Core",
        "Trash": false
      },
      {
        "Type": "Weavy.Core.Plugins.MessageDaemon, Weavy.Core",
        "Delay": "00:00:30"
      }
    ],
    "Features": {
      "ZoomMeetings": true
    },
    "Zoom": {
      "ClientId": "huax029SZ5ttDCLyg",
      "ClientSecret": "NZLETeKyX2CTr1wjJpmELmFwJQ"
    }
}