GOA-DAEMON(8)

📦
version 3.58.1 · 3 versions
, in alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ GOA-DAEMON(8) ✨

okay so bestie, welcome to the System Management Commands corner of the manual, section 8, and the star of the show is goa-daemon 💅 — GNOME Online Accounts Daemon, aka the little guy who keeps all your accounts plugged in.

🦋 NAME 🦋

goa-daemon — GNOME Online Accounts Daemon. that's it, that's the name, iconic.

🌸 SYNOPSIS 🌸

goa-daemon [--help] [--replace] [--version]

look at her. three options. minimal. lowkey a queen.

💖 DESCRIPTION 💖

so the goa-daemon program is the one that provides the org.gnome.OnlineAccounts name on the session message bus. 🫶

and here's the thing, and I need you to really hear me on this: users or administrators should never need to start this daemon. like, ever. never ever. not once. 🙈 because dbus-daemon(1) will automatically start it whenever an application sends a D-Bus message to the org.gnome.OnlineAccounts name on the session bus. it just appears. main character energy fr fr. she shows up when she's needed and you don't have to text her first. 💅

🎀 CONFIGURATION FILE 🎀

the goa-daemon program stores its config in:

$XDG_CONFIG_HOME/goa-1.0/accounts.conf

which, typically, is:

~/.config/goa-1.0/accounts.conf

now listen. 🚨 the format of this file is private, and 3rd party programs or libraries should never read it. no cap. don't peek, don't parse, don't get curious. it's not for you, bestie, it's hers. 💜

also good news: this file does not contain any passwords or secrets. so if you were worried, breathe. 🌈

if you wanna know more about $XDG_CONFIG_HOME, go check the XDG Base Directory Specification[1]. it's giving documentation. 📚

🔥 SECRETS 🔥

the goa-daemon program stores secrets (such as OAuth tokens) in GNOME Keyring[2]. 🔐

and the format of those stored secrets is also private, and 3rd party programs or libraries should never read, modify or delete these secrets. like. never. not read, not modify, not delete. all three. hands off. 😤 this is the vault and you do not have the key, periodt.

✨ OPTIONS ✨

  • --replace — replace existing instance. out with the old, in with the new, slay. 🔄
  • --version — show program version. the classic "who are you" check. ⭐
  • --help — show help options. when you're lost and need a hand. 🫶

👑 AUTHOR 👑

written by David Zeuthen <zeuthen@gmail.com> with a lot of help from many others. 💖 collaboration ate, honestly.

💀 BUGS 💀

found a bug? please send bug reports to either the distribution bug tracker or the upstream bug tracker at:

https://gitlab.gnome.org/GNOME/gnome-online-accounts/issues

and hey, there are some debugging tips at:

https://wiki.gnome.org/Projects/GnomeOnlineAccounts/Debugging

go off, report it, we love a helpful citizen. 🐛✨

🌈 SEE ALSO 🌈

dbus-daemon(1)

that's the whole list, and honestly? the only other name you need. iykyk.

📝 NOTES 📝

  1. XDG Base Directory Specification http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
  2. GNOME Keyring https://wiki.gnome.org/Projects/GnomeKeyring
okay that's the whole page!! remember: don't start the daemon, don't read the config, don't touch the secrets, and you'll be thriving. 🧚💜

and that's a wrap on this GNOME manual page, dated June 2020 — shoutout to the GNOME crew for the source and the date, mwah, thank you for coming to my ted talk, bestie. 🎀🌸💅

📦 where this page comes from