Main configuration

You can create the default configuration file with the following command:

redropp init > redropp.ini

Mandatory settings

The following settings are mandatory, and msut be set before Redropp can work:

[General]

# Your instance title
Title =

# Public-facing URL
URL =

[S3]

# Endpoint and bucket, example: https://sos-de-fra-1.exo.io/bucket
Location =

# AWS/S3 access key ID and secret access key
AccessKeyID = 
SecretKey =

[SMTP]

# Read the CURL documentation for supported URLs: https://everything.curl.dev/usingcurl/smtp.html
URL =
Username =
Password =

# Expeditor address
From =

Drop settings

Redropp provides several settings to adjust the storage allowed for each registered user. These settings are grouped in the [Drop] section:

[Drop]

# Change maximum per-user storage
Quota = 1G

# Change maximum expiration delay of drops
MaxDuration = 90d

# Allow drops without expiration delay (infinite duration)
AllowInfinite = No

Authentication methods

Only registered users can use Redropp to send files, but the download URL is public and can be shared with anyone.

By default, Redropp uses internal accounts, and anyone with a valid email can create an account. However, you can:

• Disable registration of new users
• Configure SSO providers (OIDC only)
• Disable internal authentication

Internal users

Redropp supports its own authentication method, with internal user accounts.

Internal accounts require a valid email address, which serves as the login identifier. By default, new users can create an account, and after validating their email, they can share files.

You can however disable the registration of new users, or disable internal authentication altogether, with the [Authentication] section of the config file:

[Authentication]

# Set to No to disable internal user accounts (login, registration, password loss recovery, etc.)
AllowInternal = Yes

# Set to No to disable registration of new users, including SSO accounts that did not previously
# connect to Redropp.
AllowRegister = Yes

SSO providers

Redropp only supports OpenID Connect (OIDC). You can configure one or more providers with multiple [SSO] sections in the configuration file.

This requires a provider that provides a discovery URL, which usually lives at /.well-known/openid-configuration.

[SSO]

# URL to the SSO provider, to which Redropp will append /.well-known/openid-configuration in order to fetch
# the OIDC configuration. You can instead specify the full discovery URL with the DiscoveryURL= setting.
URL = https://example.com

# OIDC client ID and secrets required by the SSO provider.
ClientID = 
ClientSecret = 

# Sets the JWT algorithm to use with this provider. Support values: RS256 (default), PS256, HS256.
# JwtAlgorithm = RS256

# Set to Yes to transparently link a new SSO account to an existing account (if any), if the mail
# addresses match.
# By default, this is disabled, but it is still possible to link to an exisiting account, but it
# requires that the user validates this by mail.
# AutoLink = No

# [SSO]
# Repeat SSO section and settings to add multiple providers

Customization

Redropp assets are bundled inside the standalone binary. However, you can use customize the logo (shown in the top menu), the favicon and provide additional script and CSS files.

To do so, change the settings in the [Customize] section of the INI config file:

[Customize]

# Replace the favicon with another image (PNG or WEBP)
# IconFile =

# Replace the top logo with another image (PNG or WEBP)
# LogoFile =

# Load and include additional CSS from specified file, you can repeat this setting
# StyleFile =

# Load and include additional JS from specified file, you can repeat this setting
# ScriptFile =

These settings and the additional files are loaded into memory on startup. You must restart Redropp after any change to these settings or to the custom script and style files for them to take effect.