📖 Preamble

In the openSUSE ecosystem — Leap or Tumbleweed — Zypper is the central tool for software management. This guide provides a clear and structured reference, organized by professional use and accessible to all levels.

👥 Target audience

📚 How to read this guide

❓ What is Zypper?

📝 Basic syntax

General structure

Pedagogical breakdown

Complete example

Additional examples

🏗️ Internal architecture: Zypper + libzypp

Zypper does not act alone: it relies on libzypp, a very powerful engine that handles dependency resolution, conflicts and transactions.

┌────────────┐ ┌──────────────────────┐ ┌──────────────────────┐
│ Zypper │ ───▶ │ libzypp │ ───▶ │ RPM / Linux System │
└────────────┘ └──────────────────────┘ └──────────────────────┘
 │ │ │
 ▼ ▼ ▼
 CLI interface Dependency resolution Installation / removal
 Commands Conflicts / vendor change Atomic transactions
 Repository priorities Snapshots (Btrfs)

Component roles

📦 Repositories

Role of repositories: the foundation of everything

Repositories are the sources of packages. Their configuration directly influences system stability.

 ┌───────────────┐
 │ OSS repo │ prio 99
 └───────────────┘
 │
 ┌───────────────┐
 │ Update repo │ prio 90
 └───────────────┘
 │
 ┌───────────────┐
 │ Packman │ prio 70
 └───────────────┘
 │
 ┌───────────────┐
 │ Misc repos │ prio 120
 └───────────────┘

Repository types

Repository structure

Repository
 ├── Name : repo-oss
 ├── URL : https://download.opensuse.org/...
 ├── Priority : 99
 ├── Auto-refresh : Yes
 └── Enabled : Yes

🔄 Repository lifecycle

Add (ar)
 │
 ▼
Modify (mr) ───► Enable / Disable
 │
 ▼
Remove (rr)

Official vs community repositories

⚠️ Sensitive repositories

🏆 Best practices Leap / Tumbleweed

⚖️ Repository priorities

The priority concept allows Zypper to choose which package to favor.

Zypper needs to install a package:
 │
 ▼
1. Repository with best priority
 │
 ▼
2. Most recent version
 │
 ▼
3. Most consistent vendor
 │
 ▼
4. Dependency resolution
 │
 ▼
5. Installation

Priority levels table

Recommended priorities

🧩 Patterns / Patches / Products

Product
 ├── Patterns
 │ ├── Packages
 │ └── Packages
 └── Patches
 ├── Fixes
 └── Updates

🔄 Leap vs Tumbleweed — In 20 seconds

🚀 Starter Pack — The 15 essential commands

Master these 15 commands to be quickly operational on openSUSE.

📦 Repository management (commands)

Inspect repositories

Add, remove, modify

📥 Installation / Update / Removal

zypper up vs zypper dup

 openSUSE Leap
 │
 ├──▶ zypper up (normal)
 └──▶ zypper dup (migration / repair)

 openSUSE Tumbleweed
 │
 └──▶ zypper dup (always)

Installation and removal

zypper in 
 │
 ▼
Search in repositories
 │
 ▼
Select best package
 │
 ▼
Install + dependencies

Package removal

zypper rm 
 │
 ▼
Dependency analysis
 │
 ▼
Safe removal

Version and lock management

🔐 Manage versions and vendors

🧹 Automatic cleanup

zypper clean
 │
 ▼
Delete cache
 │
 ▼
Lighter system

🛠️ Maintenance & Diagnosis

🔍 Detect broken packages

zypper ve
 │
 ├── Missing dependencies ?
 ├── Broken packages ?
 └── Proposed solutions

⚔️ Resolve conflicts

Conflict detected
 │
 ▼
Zypper proposes:
 1. Keep old version
 2. Change vendor
 3. Remove a package
 │
 ▼
User choice

⏸️ Identify blocking processes

zypper ps
 │
 ├── Services to restart
 ├── Processes using old libs
 └── Restart advice

🔬 Check dependencies and consistency

Consistency analysis
 │
 ├── Versions consistent ?
 ├── Vendors homogeneous ?
 ├── Duplicate packages ?
 └── Dependencies satisfied ?

🗑️ Advanced cleanup

Advanced cleanup

⚡ Advanced commands (Expert)

Change vendor (dup --from)

Advanced search

Patterns / metadata
 │
 ├── Required packages (installed)
 └── Recommended packages (missing)
 │
 ▼
 zypper install-new-recommends

Install sources

🔍 Advanced verification (verify)

zypper verify
 │
 ├── Broken dependencies ?
 ├── Inconsistent vendors ?
 ├── Incompatible versions ?
 └── Proposed solutions

🩹 Check patches (patch-check)

zypper patch-check
 │
 ├── Security patches ?
 ├── Recommended patches ?
 └── Optional patches ?

⚖️ Fine priority management

Low priority = important repository
High priority = secondary repository

Example:
Packman → 70
OSS → 99
Experimental → 120

⚠️ Dangerous commands — Red zone

💡 Why these commands are dangerous

Dangerous commands
 │
 ├── Change vendor
 ├── Downgrade packages
 ├── Force inconsistent resolutions
 ├── Remove critical dependencies
 └── Can break the system

List of dangerous commands

The most dangerous command

🗑️ Removing critical packages

Best practices before a dangerous command

🏆 Top 11 advanced Zypper commands

🎯 Advanced practical cases (GPS format)

📊 Comparison Zypper vs apt vs dnf vs pacman

Dependency resolution

Repository management

Rolling release

Command consistency and power

🔗 Complete references

Official openSUSE documentation

Man pages (local sources)

📖 Recommended readings SafeITExperts

To deepen your knowledge of Linux and openSUSE, here is a selection of complementary articles published on SafeITExperts.

🎯 Conclusion

Zypper is a demanding tool, but it rewards those who take the time to understand it. With a solid mastery of repositories, priorities and the solver, openSUSE administration becomes more predictable, more consistent and safer.

This guide does not claim to say everything: it paves the way. The rest belongs to your practice, your curiosity and your ability to make Zypper a daily ally.