Configuring the email address validation
FreshRSS can verify that users give a valid email address. It is not configured by default so you’ll have to follow these few steps to verify email addresses.
It is intended to administrators who host users and want to be sure to be able to contact them.
Force email validation
data/config.php file, you’ll find a
set it to
true. An email field now appears on the registration page and
emails are sent when users change their email.
You can also enable this feature directly in FreshRSS:
System configuration > check
Force email addresses validation.
Configure the SMTP server
By default, FreshRSS will attempt to send emails with the
To configure a SMTP server, you’ll have to modify the
First, change the
mailer item to
smtp (instead of the default
Then, you should change the
smtp options like you would do with a regular email client.
You can find the full list of options in the
If you’re not sure to what each item is corresponding, you may find useful the
(which is used by FreshRSS under the hood).
Example code to configure SMTP server
'mailer' => 'smtp', // instead of 'mail' 'smtp' => array( 'hostname' => 'example.net', 'host' => 'smtp.example.net', // URL to your smtp server 'port' => 465, 'auth' => true, 'auth_type' => '', 'username' => 'alice', // or maybe email@example.com 'password' => 'yoursecretpassword', 'secure' => 'ssl', // '', 'ssl' or 'tls' 'from' => 'firstname.lastname@example.org', ),
Check your SMTP server is correctly configured
To do so, once you’ve enabled the
force_email_validation option, you only
need to change your email address on the profile page and check that an email
arrives on the new address.
If it fails, you can change the environment (in
data/config.php file, change
development). PHPMailer will become more verbose and you’ll
be able to see what happens in the PHP logs. If something’s wrong here, you’ll
probably better served by asking to your favorite search engine than asking us.
If you think that something’s wrong in FreshRSS code, don’t hesitate to open a
Also, make sure the email didn’t arrive in your spam.
Once you’re done, don’t forget to reconfigure your environment to
Access the validation URL during development
You might find painful to configure a SMTP server when you’re developping and
- the username of the user to validate (you should know it)
- its validation token, that you’ll find in its configuration file:
$ # For instance, for a user called `alice` $ grep email_validation_token data/users/alice/config.php | cut -d \' -f 4 - 3d75042a4471994a0346e18ae87602f19220a795
Then, the validation URL should be
Don’t forget to adapt this URL with the correct port, username and token.