Help Topics
App Passwords
Using app-specific passwords is a security best practice. These passwords are tied to specific applications and can be revoked individually without affecting your main account password.
Most email providers require app-specific passwords for third-party applications like magpie. Follow the instructions below for your specific provider:
IMAP Custom Configuration
To configure an email source in magpie, you'll need the following information:
IMAP Server Host
The hostname of your email provider's IMAP server (e.g., imap.gmail.com)
Port
The port number for the IMAP server (typically 993 for SSL/TLS)
Username
Your full email address (e.g., user@example.com)
Password
An app-specific password (not your main account password)
Troubleshooting
Authentication Failed
If you're receiving authentication errors, try the following:
- Ensure you're using an app-specific password, not your main account password
- Double-check that your username is your full email address
- Verify that IMAP access is enabled in your email provider's settings
- Check for any security alerts from your email provider about a new sign-in
Connection Timeout
If you're experiencing connection timeouts, try these solutions:
- Verify the IMAP server hostname and port are correct
- Check if your firewall or network is blocking the connection
- Try connecting to the server using another email client to verify connectivity
- Ensure SSL/TLS is enabled if required by your provider
Emails Not Forwarding
If emails aren't being forwarded, check the following:
- Ensure the MonitorLoop service is running
- Check that you have both an input and output source configured
- Verify the output source is marked as "Is Output"
- Check the statistics page for any errors
- Review the logs for detailed error messages
Frequently Asked Questions
How often does magpie check for new emails?
magpie's MonitorLoop service polls for new emails every 15 minutes when active. This interval is designed to balance timely email forwarding with resource usage.
Can I have multiple output sources?
No, magpie currently supports only one output source. This is by design to ensure emails are forwarded to a single destination. You can, however, have multiple input sources.
Are my emails stored on the server?
No, magpie does not store the content of your emails. It only retrieves emails from the input source and forwards them to the output source. Statistics about forwarded and deleted emails are stored, but not the email content itself.
Can I run magpie in Docker?
Yes, magpie is designed to be Docker-friendly. You can run it using the official Docker image with the following command:
Need More Help?
If you couldn't find the answer to your question in our documentation, please reach out to our support team: