Account Setup

🔍 Prerequisites Check
Before adding accounts to Cypht, ensure you have completed the essential setup steps. Account setup requires a fully functional Cypht installation.
Complete These First
  • Installation: Cypht must be deployed on your web server with proper PHP configuration

Need help? Go to Installation Guide

Supported Account Types
Cypht supports multiple account types, allowing you to centralize various communication channels in one interface.
JMAP/IMAP/SMTP/ Servers

Standard email accounts including Gmail, Outlook, Yahoo, and custom domain emails. Supports SSL/TLS encryption and various authentication methods.

RSS/Atom Feeds

News feeds, blogs, and content streams displayed as message threads. Perfect for staying updated with your favorite sources.

Exchange Web Services

Microsoft Exchange and Office 365 accounts with full calendar and contact synchronization capabilities.

LDAP/Server

Corporate directory services and local contact databases for integrated address book functionality.

Adding Email Accounts
Configure your email accounts with the proper server settings and authentication credentials.
1. Access Account Settings

Navigate to Settings → Accounts in the top navigation bar. Click "Add Account" to begin the configuration process.

2. Basic Account Information

Enter the essential details for your email account:

  • Account Name: A descriptive name for identification (e.g., "Work Email", "Personal Gmail")
  • Email Address: Your complete email address
  • Display Name: Name that appears in sent messages
  • Reply-to Address: Optional alternative reply address
3. Server Configuration

Configure the incoming and outgoing mail servers:

IMAP (Incoming)
  • Server: imap.gmail.com (example)
  • Port: 993 (SSL) or 143 (STARTTLS)
  • Encryption: SSL/TLS recommended
  • Username: Your full email address
  • Password: Your account password
SMTP (Outgoing)
  • Server: smtp.gmail.com (example)
  • Port: 587 (STARTTLS) or 465 (SSL)
  • Encryption: STARTTLS recommended
  • Authentication: Required
  • Username: Same as IMAP
Auto-Discovery

Cypht can automatically detect server settings for many popular email providers. Simply enter your email address and password, then click "Auto-Configure" if available.

Security & Authentication
Modern email services often require additional security measures for third-party applications.
App-Specific Passwords

Many providers (Google, Microsoft, Yahoo) require app-specific passwords instead of your regular password:

Google/Gmail

Enable 2-Step Verification, then generate an App Password in your Google Account settings.

Microsoft/Outlook

Use App Passwords or OAuth2 authentication for Office 365 and Outlook accounts.

Corporate Email

Contact your IT administrator for proper server settings and authentication requirements.

Security Note

Never share your app-specific passwords. They provide direct access to your email account. Revoke them immediately if suspicious activity is detected.

Adding RSS/Atom Feeds
Transform your favorite content sources into readable message threads within Cypht.
Feed Configuration
  1. Click Settings → Accounts → Add Account
  2. Select "RSS/Atom Feed" as account type
  3. Enter the Feed URL (e.g., https://example.com/feed.xml)
  4. Choose a Display Name for the feed
  5. Set Update Frequency (hourly, daily, manual)
  6. Click Test Connection to verify the feed
  7. Save and the feed will appear in your folder list
Popular Feed Sources

News sites, blogs, GitHub repositories, project management tools, and notification services often provide RSS feeds for staying updated with latest content.

Advanced Settings
Fine-tune your account configuration for optimal performance and functionality.
  • Folder Prefix: Specify IMAP folder prefix (INBOX., etc.) for server compatibility
  • Connection Limits: Set maximum concurrent connections to prevent server overload
  • Message Limits: Configure how many messages to sync per folder
  • Signature Management: Create and manage email signatures per account
  • Notification Settings: Configure desktop or email notifications for new messages
Troubleshooting Common Issues
Resolve common account setup issues with these solutions.
Connection Failed

Check server settings, firewall rules, and ensure SSL/TLS ports are open. Verify credentials and try app-specific passwords.

See Issues
Authentication Error

Enable two-factor authentication and generate app passwords. Verify that the username matches the email address format.

See Issues
Sync Issues

Increase connection limits, check server quotas, and verify folder permissions. Use manual refresh if needed.

See Issues
Security Blocks

Review account security settings, allow less secure app access if needed, or use OAuth2 authentication.

See Issues
Folder Configuration

Check system folder mappings (Inbox, Sent) and IMAP folder prefixes (like INBOX.) for server compatibility.

See Issues
SSL/TLS Certificate Issues

Ensure certificates are up to date and properly configured. For self-signed certificates, add them to trusted certificates.

See Issues

On this page