Get started

Get to know 1Password for Linux

If you're new to 1Password, learn how to install and use the Linux app to manage your passwords, credit cards, secure notes, and more.

1Password for Linux is the simple, beautiful password manager you’ve been looking for. Easily organize your secure information, save and fill passwords in your web browser, and have everything available at your fingertips.

Important

1Password for Linux is a read-only development preview. Many features are missing or incomplete. You can sign in, view items, search, copy, and more, but you can’t edit or create anything.

Get 1Password

You can get 1Password from the Snap Store or install it using your package manager.
Get 1Password from the Snap store

Debian or Ubuntu

Install 1Password using your package manager:

  1. Add the key for the 1Password apt repository:

     sudo apt-key --keyring /usr/share/keyrings/1password.gpg adv --keyserver keyserver.ubuntu.com --recv-keys 3FEF9748469ADBE15DA7CA80AC2D62742012EA22
    
  2. Add the 1Password apt repository:

     echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/1password.gpg] https://onepassword.s3.amazonaws.com/linux/debian edge main' | sudo tee /etc/apt/sources.list.d/1password.list
    
  3. Install 1Password:

     sudo apt update && sudo apt install 1password
    

CentOS, Fedora, or Red Hat Enterprise Linux

Install 1Password using your package manager:

  1. Add the key for the 1Password yum repository:

     sudo rpm --import https://onepassword.s3.amazonaws.com/linux/keys/1password.asc
    
  2. Add the 1Password yum repository:

     sudo sh -c 'echo -e "[1password]\nname=1Password\nbaseurl=https://onepassword.s3.amazonaws.com/linux/rpm\nenabled=1\ngpgcheck=1\nrepo_gpgcheck=1\ngpgkey=https://onepassword.s3.amazonaws.com/linux/keys/1password.asc" > /etc/yum.repos.d/1password.repo'
    
  3. Install 1Password:

     sudo dnf install 1password
    

The packages and repository are signed with the GPG key 3FEF9748469ADBE15DA7CA80AC2D62742012EA22.

AppImage

You can also download 1Password as an AppImage to use on other distributions. Learn how to use an AppImage. 

Add an account

To use 1Password, you need a 1Password membership.

To add an account, open 1Password and click “Visit 1Password.com to sign in”. Then follow the onscreen instructions. When you’re done, open the 1Password app, enter your password, and click “Sign in”.

Get 1Password in your browser

1Password X lets you fill passwords, credit cards, and addresses directly in Firefox, Chromium, or Brave.

Learn how to get and use 1Password X.

Search 1Password

Searching is the fastest way to find what you need in 1Password.

To search in 1Password, use the search field at the top of the window (Control-F).

Search 1Password to find what you need

Switch vaults and accounts

You can use vaults in 1Password to organize your items and share them with others. If you have multiple 1Password accounts, each account has its own vaults.

To see only the vaults from one account, click the account or collection at the top of the sidebar and choose the account.

To view items in a specific vault, click the account or collection at the top of the sidebar and choose the account where the vault is located. Then click the vault in the sidebar.

vaults listed in the sidebar

Organize your vaults into collections

You can use collections to group and organize your vaults, even across multiple accounts. If you have multiple 1Password accounts, the Everything collection shows all the vaults in your unlocked accounts.

To add a new collection, click the account or collection at the top of the sidebar and choose Manage Collections. Select the vaults to include, then name the collection.

your collections and accounts menu in the sidebar

See who has access to an item

If you share vaults with others, you can see who has access to an item. Click above the item’s title to see a list of people and groups who have access to it.

If you don’t see , then only you have access to the item.

menu showing where an item is located and who has access to it

Use Watchtower

Watchtower tells you about password breaches and other security problems on the websites you have saved in 1Password. Click Watchtower in the sidebar to get a report for the current account or collection.

Learn more about Watchtower.

Use Watchtower in the sidebar

Enlarge passwords

You can temporarily enlarge a password to make it easier to see while entering it on another device or reading it aloud.

To enlarge a password, hover over it. Then click and choose Show in Large Type.

Click 'Show in Large Type' to enlarge passwords

Lock 1Password

When you’re done using 1Password, you can lock it. To lock 1Password, click the account or collection at the top of the sidebar and choose Lock (Control-Shift-L). Unlock 1Password again by entering your account password.

Manage your settings

To change your settings:

  1. Open and unlock 1Password.
  2. Click the account or collection at the top of the sidebar and choose Settings.
  3. 1Password will open a JSON-formatted settings file (~/.config/1Password/settings/settings.json) in your default text editor. Edit the file to add or change settings. See an example.
  4. Close and save the file. Your changes will take effect immediately.

Appearance settings

DescriptionSettingPossible values
Always show 1Password in the notification areaapp.keepInTraytrue
false
Change the appearance of the appapp.theme"dark"
"light"
"system"

Security settings

DescriptionSettingPossible values
Clear clipboard contents aftersecurity.clipboard.clearAfternumber of seconds
(0 for never)
Lock after the computer is idlesecurity.autolock.minutesnumber of minutes
(0 for never)
Lock when you close the appsecurity.autolock.onWindowClosetrue
false
Lock when your system locks or sleepssecurity.autolock.onDeviceLocktrue
false
Unlock using the system authentication servicesecurity.authenticatedUnlock.enabledtrue
false

Example settings file

{
  "$schema": "https://onepassword.s3.amazonaws.com/schema/settings.json",
  "app.theme": "dark",
  "security.autolock.minutes": 20,
  "security.autolock.onWindowClose": true,
  "security.clipboard.clearAfter": 60
}

Update 1Password

If you installed 1Password from a package, use the command for your package manager to check for an update and install it if available:

DistributionRun this command
Debian or Ubuntusudo apt update && sudo apt upgrade 1password
CentOS, Fedora, or Red Hat Enterprise Linuxsudo dnf upgrade 1password --refresh

Get help

If you don’t see new items or updated information in 1Password, restart your computer and try again. If it’s still not working, quit 1Password and delete the 1Password accounts file (~/.config/1Password/1password.sqlite). Then start 1Password and add your account again.

If you use GNOME and the 1Password icon doesn’t appear in your system tray, install the AppIndicator shell extension  .

1Password for Linux requires glibc 2.28 and a computer with a 64-bit x86 processor. The following distributions are supported:

  • CentOS 8 or later
  • Debian 10 or later
  • Fedora 29 or later
  • Red Hat Enterprise Linux 8 or later
  • Ubuntu 18.04 LTS or later (Snap)
  • Ubuntu 20.04 LTS or later (package)

Learn more

Published: