> For the complete documentation index, see [llms.txt](https://devise-token-auth.gitbook.io/devise-token-auth/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devise-token-auth.gitbook.io/devise-token-auth/config/email_auth.md).

# Email Authentication

If you wish to use email authentication, you must configure your Rails application to send email. [Read here](http://guides.rubyonrails.org/action_mailer_basics.html) for more information.

I recommend using [mailcatcher](https://mailcatcher.me/) for development.

#### mailcatcher development example configuration:

```ruby
# config/environments/development.rb
Rails.application.configure do
  config.action_mailer.default_url_options = { host: 'your-dev-host.dev' }
  config.action_mailer.delivery_method = :smtp
  config.action_mailer.smtp_settings = { address: 'your-dev-host.dev', port: 1025 }
end
```

You also may want to configure `mail_sender` at devise initializer if you don't use your own mailer class

#### devise configuration:

```ruby
# config/initializers/devise.rb
Devise.setup do |config|
  config.mailer_sender = "example@example.com"
end
```

If you wish to send custom e-mails instead of using the default devise templates, you can [do that too](/devise-token-auth/usage/overrides.md#email-template-overrides).