How to Set Up and Use the Geary Email Client on Linux

Geary is a lightweight Linux email client built around conversations. To get started, install Geary, add an email account, let the first synchronization finish, and then use its simple three-pane interface to read, search, write, and manage mail.

One important update from older guides: as of October 2026, Geary's upstream stable feature release is still 46.0, released May 20, 2024. Linux distributions may ship newer package revisions of that same upstream version. The current Flathub listing also offers Geary 46.0, but Flathub marks that package as community-provided and unverified. You can review the Geary release notes and the Flathub Geary listing before choosing how to install it.

1. Install Geary on Linux

The easiest option is usually your distribution's package manager. Open a terminal and use the command for your system:

Ubuntu or Debian: sudo apt update && sudo apt install geary
Fedora: sudo dnf install geary
Arch Linux: sudo pacman -S geary
Flatpak: flatpak install flathub org.gnome.Geary

If you use Flatpak, make sure Flatpak and the Flathub remote are already configured. If you prefer distribution packages, remember that the exact Geary package revision depends on the Linux release you are running.

2. Add your email account securely

Launch Geary from your applications menu. If no account is configured, Geary opens its account setup flow. You can choose a supported provider or use the option for another IMAP server when your mail service is not listed.

Geary account setup window showing Google, Outlook.com, Yahoo, and Other IMAP Server choices
A Geary-style account setup view showing common providers plus an Other IMAP Server option.

On a GNOME desktop, the preferred route for providers such as Google is often Settings > Online Accounts. Add the provider there, complete the provider's web-based authorization, and keep Mail access enabled. Geary is designed to pick up compatible accounts from GNOME Online Accounts. GNOME explains how this integration works in its Online Accounts documentation.

For Gmail, avoid outdated instructions that tell you to enable "Less secure apps." Google recommends OAuth or Sign in with Google for third-party mail clients instead of handing the app your normal account password. See Google's current Gmail third-party client guidance. If you must configure a generic IMAP account manually, copy the incoming and outgoing server details from your email provider's official support page rather than guessing ports or security settings.

3. Read mail and understand the inbox

After the first synchronization, Geary organizes messages into conversations. The left side contains folders such as Inbox, Starred, Sent, Drafts, Archive, Trash, and Spam when your provider exposes them. The center lists conversations, while the reading pane shows the selected thread.

Geary inbox with folders, a list of email conversations, and an open Project update message
Geary's conversation layout places folders, the message list, and the selected message side by side.

Select any conversation to read it. Newer messages in the same discussion are grouped together, so you do not have to jump between separate copies of every reply.

4. Compose and send a message

Click the compose button to start a new email. Add one or more recipients, enter a subject, write the message, and attach files if needed. Geary's composer supports both plain text and formatted HTML mail.

Geary new message composer with To, Cc, Subject, formatting, attachment, and Send controls
Use the composer to enter recipients, a subject, message text, formatting, and attachments before sending.

Review the recipient list before pressing Send, especially when using Cc or Bcc. If delivery fails because the account credentials changed, reauthorize the account through GNOME Online Accounts or update the IMAP/SMTP credentials for a manually configured account.

5. Search, reply, archive, and delete mail

Use the search field to find conversations by words in the sender, subject, or message content. This is especially useful when an inbox has thousands of messages.

Geary search results for the word project showing several matching conversations
Search filters conversations by matching terms such as subject or message text.

When a message is open, use the visible controls to Reply, Reply All, or Forward. Archiving removes a conversation from the Inbox while keeping it in the account's archive when the provider supports that behavior. The trash/delete control normally moves mail to the provider's Trash folder; permanent deletion rules are controlled by the mail service.

Open Geary message with Reply, Reply All, Forward, Archive, Delete, and More buttons
An open message provides the main reply, forwarding, archive, delete, and additional actions.

For less common commands, open Geary's application menu. The built-in documentation says keyboard shortcuts are available from the app menu and can also be opened with Ctrl+?.

Geary application menu showing Accounts, Preferences, Keyboard Shortcuts, Help, and About Geary
The application menu provides quick access to account settings, preferences, keyboard shortcuts, help, and version information.

Troubleshooting common setup problems

  • Gmail keeps rejecting the password: remove the manually configured account and use GNOME Online Accounts or another OAuth-based sign-in path. A normal Google password is not the right fallback for older password-only authentication.
  • Mail does not appear: check that the correct account and folder are selected, confirm the computer is online, and let the initial IMAP synchronization complete.
  • A custom provider will not connect: verify the official IMAP and SMTP host names, ports, encryption method, username format, and authentication requirements from that provider.
  • You need a command or shortcut: press F1 for Geary help or Ctrl+? for the shortcut reference, as documented by the Geary project.

Geary remains appealing when you want a focused Linux mail client rather than a full personal-information manager. Its biggest strengths are straightforward account setup, conversation-based reading, fast search, and a clean composer; just keep the current authentication requirements of your email provider in mind when following older Linux tutorials.

Leave a Comment

How to Record Speaker Output on Linux with Audacity

How to Record Speaker Output on Linux with Audacity

Capture Linux desktop audio in Audacity by routing its recording stream to your output device’s monitor source. Follow PulseAudio and PipeWire steps, export tips, and fixes for silent tracks.

How to Use Dropbox on Linux: Install and Sync Your Files

How to Use Dropbox on Linux: Install and Sync Your Files

Install Dropbox on Linux from the official package, sign in, sync a local folder, manage selective sync, and check status from the command line.

How to Install Inkscape on Linux: Ubuntu, Fedora, Arch, and More

How to Install Inkscape on Linux: Ubuntu, Fedora, Arch, and More

Install Inkscape from your Linux distribution’s repositories, the Ubuntu stable PPA, Snap, or Flathub, with current commands and notes for choosing a package source.

How to Find and Remove Duplicate Files on Linux With FSlint

How to Find and Remove Duplicate Files on Linux With FSlint

Use FSlint to scan selected Linux folders, review duplicate groups, and safely delete redundant files or learn when hard-link merging is appropriate.

How to Install SABnzbd on Linux and Configure It

How to Install SABnzbd on Linux and Configure It

Install SABnzbd on Ubuntu or Debian, or run it in Docker on another Linux host. Then open the web interface and configure your provider and download folders.

How to Install the Paper GTK Theme on Linux

How to Install the Paper GTK Theme on Linux

Install the Paper GTK theme from supported Linux repositories, enable it for GTK apps in GNOME Tweaks, and see what the legacy theme can and cannot change.

How to Install and Set Up Plex on OpenMediaVault with Compose

How to Install and Set Up Plex on OpenMediaVault with Compose

The old OpenMediaVault Plex plugin is archived. Set up Plex on OMV 8 with OMV-Extras, the Compose plugin, persistent storage, and Plex’s official container.

How to Clean and Speed Up Ubuntu Safely

How to Clean and Speed Up Ubuntu Safely

Clean and speed up Ubuntu with safe APT cleanup, storage checks, and startup controls that help free space and troubleshoot a sluggish desktop.

How to Install the Hiri Email Client on Linux

How to Install the Hiri Email Client on Linux

Install Hiri on Linux with its Snap package or official tarball, add a desktop launcher, and check supported accounts plus a warning about Hiri’s old Snap release.

How to Get System Specifications for a Linux PC

How to Get System Specifications for a Linux PC

Use Fastfetch and built-in Linux commands to check your distro, kernel, CPU, memory, graphics, storage, and connected devices, then save a clear report.