Skip to content
This repository was archived by the owner on Aug 29, 2025. It is now read-only.

Commit a5a154b

Browse files
authored
Update ubuntu setup instructions (#303)
* Update ubuntu instructions * Add info on situations that need gnome-keyring-daemon
1 parent 40f9bd9 commit a5a154b

File tree

1 file changed

+16
-8
lines changed

1 file changed

+16
-8
lines changed

README.md

Lines changed: 16 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ Download from browser OR via Curl
9494
curl -LO <link> && tar -xzf <filename>
9595
```
9696

97-
#### Linux environment setup (Required)
97+
#### Linux (Ubuntu) environment setup (Required)
9898

9999
The linux environment setup is similar to the Mac setup, but with one difference. For headless linux environments,
100100
there's an additional step to configure the keyring for access token encryption.
@@ -125,21 +125,29 @@ Failure to set this up will result in authentication failures.
125125

126126
Required packages:
127127

128-
1. gnome-keyring
128+
1. systemd (ensure the dbus service is properly set up)
129129
2. dbus
130-
3. libsecret
131-
4. libcap
130+
3. gnome-keyring
132131

132+
> On WSL, systemd can be enabled by following [these instructions](https://learn.microsoft.com/en-us/windows/wsl/systemd)
133+
134+
1. Install gnome-keyring
133135
``` bash
134-
sudo apt-get install --assume-yes gnome-keyring libsecret-1-0
136+
sudo apt-get install --assume-yes gnome-keyring
135137

136-
sudo setcap cap_ipc_lock=+ep $(which gnome-keyring-daemon)
138+
```
137139

138-
export DBUS_SESSION_BUS_ADDRESS=$(dbus-daemon --session --fork --print-address)
140+
2. If running in a headless environment(e.g. WSL), you may need to run the following commands as well to start gnome-keyring in your shell session:
139141

142+
```bash
140143
export KEYRING_PASSWORD=any-password
141144

142-
dbus-run-session -- echo "$KEYRING_PASSWORD" | gnome-keyring-daemon --daemonize --components=secrets --unlock
145+
printf '%s' "$KEYRING_PASSWORD" | gnome-keyring-daemon --daemonize --components=secrets --unlock
146+
```
147+
148+
3. Run mgc
149+
150+
```bash
143151

144152
mgc login
145153
```

0 commit comments

Comments
 (0)