Troubleshooting¶

[!TIP] Run gsm doctor first — it checks all 5 connectivity requirements and tells you exactly what's wrong.

Common issues and solutions for gsuite-manager.

Authentication¶

rm -f ~/.config/gsm/token.json
gsm setup  # re-authenticate

[!WARNING] Your Google Workspace account needs Super Admin role. Delegated admin won't work for domain/user management APIs.

DNS propagation can take 5-60 minutes. gsm polls automatically, but if it times out:

gsm health --domain example.com  # check current state
gsm domains verify example.com   # retry verification

gsm auto-detects and disables Email Routing before injecting MX records. If you see conflicts:

# Check CF dashboard → Email → Email Routing → disable
gsm domains add example.com  # retry (idempotent)

Ensure you installed in the active venv:

source .venv/bin/activate
pip install -e .
which gsm  # should point to .venv/bin/gsm

Set terminal to UTF-8:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$env:PYTHONIOENCODING = "utf-8"

gsm auto-recovers from corrupt JSON entries. If the ledger is completely broken:

# Backup and reset
cp ~/.config/gsm/ledger.json ~/.config/gsm/ledger.json.bak
echo '{"domains": {}, "users": {}}' > ~/.config/gsm/ledger.json