Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.safedep.io/llms.txt

Use this file to discover all available pages before exploring further.

Package Guard shows package installs and usage across your endpoints. It runs on pmg, the open-source Package Manager Guard CLI that intercepts package manager commands and syncs the activity to SafeDep Cloud.

Prerequisites

Enable cloud sync

1

Run the PMG setup installer

$ pmg setup install

█▀█ █▀▄▀█ █▀▀  From SafeDep (github.com/safedep/pmg)
█▀▀ █░▀░█ █▄█  version: v0.9.0 commit: c3a351

✓ PMG aliases installed successfully
  Installed to:  /home/user/.pmg.rc
  Config at:     /home/user/.config/safedep/pmg
  Restart your terminal or source your shell to use the new aliases
2

Enable cloud sync in the PMG config

Open the PMG config at ~/.config/safedep/pmg/config.yml (run pmg setup info to confirm the path) and add the cloud sync block, keeping any existing settings:
# ~/.config/safedep/pmg/config.yml
cloud:
  enabled: true
# other existing settings...
3

Login to SafeDep Cloud

Authenticate with your tenant details:
pmg cloud login
Enter your tenant ID and tenant domain when prompted.
4

Sync to SafeDep Cloud

pmg cloud sync
Run this after login and whenever you want to push new local activity to SafeDep Cloud.

Common sync patterns

  • After dependency updates: run pmg cloud sync once installs or upgrades complete.
  • In CI/CD pipelines: add pmg cloud sync as a post-step after pmg runs.
  • Scheduled: use cron for nightly syncs, e.g. 0 0 * * * pmg cloud sync.

View package events in SafeDep Cloud

After syncing, open app.safedep.io, select Endpoints in the sidebar, and pick your endpoint to see the Package Events timeline. SafeDep Cloud Endpoints page showing package events

Next steps

PMG Quickstart

Install PMG and learn the basics

SafeDep Cloud Sync

Learn how cloud sync works across SafeDep tools