Skip to content
jdalbey edited this page Mar 18, 2025 · 11 revisions

Installation

Questions about System Requirements and Installation.

Q: Where can I find a download for my operating system?
A: Look on this Releases page for the latest release and look for "Available Downloads".

Usage

Questions about using EasyAuth.

Q: What is an authenticator?
A: An authenticator is a tool that adds an extra layer of security to your online accounts by generating one-time passcodes for two-factor authentication (2FA). It helps protect your accounts by adding a second authentication factor alongside your password.

Q: The website I use already sends me a text message when I login, how is EasyAuth different?
A: EasyAuth doesn't require a phone, it's a desktop application running on the same computer where you access your online sites. You don't have to wait for a text message or manually type in the verification code. Verifying your identity takes just a simple copy-and-paste operation. In theory, verification via text message leaves open the possibility of the message being intercepted by hackers. The one-time passcodes generated by EasyAuth expire after 30 seconds so it’s harder for someone else to use a code, even if they’re peeking over your shoulder.

Q: Is EasyAuth as secure as a phone authenticator like Google Authenticator?
A: There are pros and cons to each. EasyAuth is for people who don't use a smartphone (or just want to avoid the hassle of phone-based authentication). For people who are more likely to lose their phone than lose their workstation, EasyAuth may be the best option. If you travel with your laptop and there's a chance it could be lost or stolen then a phone-based authenticator is probably a better choice.

Q: How do I migrate my accounts from EasyAuth to another device?
A: There are two options. From the Edit Account dialog click "Reveal QR code" to display a QR code that can be scanned and used by an alternate authenticator app. For bulk migration tasks use the Export feature.

Q: Why isn't export file encrypted?
A: The reason to export is to transfer accounts to another device or application. This is a process that doesn't take long and having to enter encryption keys would make the process more tedious and error-prone. Once the transfer is complete the exported file is no longer needed so it should be securely deleted (not just moved to the Trash).

Q: Where can I learn more about Time-based One-time Passwords (TOTP)?
A: There are numerous articles on the web. This one is pretty good.

Q: How does EasyAuth protect my personal data?
A: EasyAuth gathers no personal data from users. The information entered into the vault remains on your computer. EasyAuth runs on your computer not on some cloud service. In addition, EasyAuth has no advertising.

Troubleshooting

Common problems and solutions.

Q: I want to use EasyAuth on my laptop computer as well as my workstation. How do I migrate my accounts?
A: Use the Export feature to create an external file that you transfer to your laptop. On the laptop use the Import feature to load the accounts into your vault.

Q: When I run EasyAuth on Linux I get this error message:
[PYI-5985:ERROR] Failed to load Python shared library '/tmp/_MEI5pJSlP/libpython3.10.so.1.0': dlopen: /lib/x86_64-linux-gnu/libm.so.6: version 'GLIBC_2.35' not found (required by /tmp/_MEI5pJSlP/libpython3.10.so.1.0)
A: GLIBC (GNU C Library) is the standard C library used by most Linux distributions. This error indicates that your Linux kernel is using an older version of GLIBC than what EasyAuth was created on. It is commonly found in Linux distributions with kernel versions around 5.15+. You can determine the current version you have with this terminal command: ldd --version Until I find a better solution, it seems like upgrading the GLIBC library or the kernel itself may fix the problem.

Q: When registering with a website for 2FA I was able to scan the QR code into EasyAuth but then I got distracted and by the time I entered the TOTP into the website it had timed out. So I have to start the registration process over with a new QR code. However EasyAuth says "A vault entry with Provider and user already exists".
A: Delete the faulty vault entry and then re-register with the website. Directions

Clone this wiki locally