Configuration¶

In this section we'll cover all the features that are available to administrative users with the "System settings" permission. Please note that in managed installations some configuration options are managed as part of the service.

The configuration is accessible from the "Settings" Menu in the left navigation bar.

Organization¶

This section allows you to edit your organization information and optionally upload a logo to adapt Filesight to your brand.

The organization information is organized in different fields that can be used for defining email templates. None of these fields are mandatory.

You can optionally upload a custom logo that will be used in the application top bar, both in the administrators and in the viewers interface.

Legal info¶

This section allows you to upload a file that, if present, is shown to the final users as "terms and conditions" that must be accepted when registering to Filesight (via the invitation link created by the platform). This document is also accessible from the user's profile.

Email¶

This section allows you to control if email notifications are active and to configure SMTP settings for sending emails. Currently, the only mails sent from Filesight are:

• registration invites when a user is created
• password recovery instructions, triggered by a "lost password?" link on the login form.

If email sending is not enabled, these two features will not be available. In this case administrators will be able to manually generate invitation and password reset links for registered users, and send these links with manual emails or other messaging systems.

Email templates¶

This section allows the configuration of the invitation and password reset emails. The two templates can be edited and it is possible to insert company info by using tokens defined in the Organization configuration. Email templates are initially configured with a default message in English. The default message can be easily restored if necessary with a specific button in the template editor.

Storage¶

The storage configuration is the most important setting in Filesight, as it determines where your files are physically stored. You have two options: - storing files locally in the Filesight server instance - storing files in an S3-compatible bucket (such as Amazon S3, DigitalOcean Spaces, etc.)

Local storage¶

If you opt for local storage, the files will be stored directly in your Filesight server instance. This option requires no further configuration. Keep in mind that the size of the disk of your instance will become limiting for file storage. At the moment, it is not possible to specify the location of the mount, and Filesight will rely on the filesystem mounted on the root folder.

S3 compatible storage¶

Another option for storing your files is using an S3-compatible storage, such as Amazon S3 or DigitalOcean Spaces. If you select this option, you will need to provide:

• S3 endpoint
• S3 Bucket
• S3 Region
• S3 Access Key
• S3 Secret Key

You can get this information from your S3 bucket provider.

Storage migration¶

When you change your storage setting, passing from local to S3 and vice versa, or changing S3 parameters, a file migration will be initiated. During the migration, the system will remain usable, but file access and upload won't be available until the migration completes.

Also the software update procedure won't be available during a migration.

During the migration, in the "Files Management" section, you will see a warning saying: "File migration to the new storage system is in progress. Some features may be limited until the migration is complete."

Security options¶

This section allows you to manage options related to user login. Here it is possible to configure how many times a user can fail to log in before the temporary block of 10 minutes.

HTTPS¶

The HTTPS section lets you control the use of an optional SSL certificate (provided by Let's Encrypt) that can be managed automatically by Filesight. It is possible to enable the automatic certificate provisioning by specifying:

• the domain for the certificate.
• an email address: Let's Encrypt requests an email address primarily to send critical warnings about certificate expiration and, formerly, to notify users about deprecated ACME client versions.

Please note that it is not strictly required to use the included HTTPS certificate management: for providers such as AWS, another possible solution is to handle the certificate yourself using a Load Balancer to handle the SSL termination. Please refer to your cloud provider documentation for such configuration.

Software updates¶

The software update shows information about the available software updates. If a software update is available, pressing the "Run update" button will trigger the update process.

Once an update is started, Filesight will be put in maintenance mode. During the update, a courtesy page is shown and the software is not usable. When the update has finished, the system should restart automatically and you should be able to use the software as normal.

If the software update fails, Filesight will be restored to the version you were using before starting the update.