.\
.\"
.TH "DISTROBOX\-UPGRADE" "1" "Mar 2026" "Distrobox" "User Manual"
.SH "نام (NAME)"
distrobox\-upgrade \- ارتقای کانتینرهای distrobox با استفاده از مدیر بسته
.SH "توضیحات (DESCRIPTION)"
دستور distrobox\-upgrade وارد فهرست کانتینرهای مشخص‌شده می‌شود و با
استفاده از مدیر بستهٔ کانتینر، عملیات ارتقا را انجام می‌دهد.
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]distrobox upgrade\f[R]
.IP
.EX
\-\-help/\-h:      نمایش این پیام
\-\-all/\-a:       انجام عملیات برای تمام distroboxها
\-\-running:      انجام عملیات تنها برای distroboxهای در حال اجرا
\-\-root/\-r:      اجرای podman/docker/lilipod با امتیازات root. توجه داشته باشید که اگر به root نیاز دارید، این روش نسبت
            به \[dq]sudo distrobox\[dq] ارجح است (نکته: در صورتی که استفاده از برنامه‌ای غیر از \[aq]sudo\[aq] برای دسترسی‌های root لازم است،
            آن را از طریق متغیر محیطی DBX_SUDO_PROGRAM یا متغیر پیکربندی \[aq]distrobox_sudo_program\[aq] مشخص کنید)
\-\-verbose/\-v:       نمایش جزئیات بیشتر
\-\-version/\-V:       نمایش نسخه
.EE
.SH "مثال‌ها (EXAMPLES)"
ارتقای تمام distroboxها
.IP
.EX
distrobox\-upgrade \-\-all
.EE
.PP
ارتقای تمام distroboxهای در حال اجرا
.IP
.EX
distrobox\-upgrade \-\-all \-\-running
.EE
.PP
ارتقای یک distrobox مشخص
.IP
.EX
distrobox\-upgrade alpine\-linux 
.EE
.PP
ارتقای فهرستی از distroboxها
.IP
.EX
distrobox\-upgrade alpine\-linux ubuntu22 my\-distrobox123
.EE
.PP
\f[B]به‌روزرسانی خودکار تمام توزیع‌ها\f[R]
.PP
می‌توانید یک سرویس systemd ایجاد کنید تا distrobox\-upgrade را به‌طور
خودکار انجام دهد؛ این مثال نحوهٔ اجرای روزانهٔ آن را نشان می‌دهد:
.PP
\[ti]/.config/systemd/user/distrobox\-upgrade.service
.IP
.EX
[Unit]
Description=distrobox\-upgrade Automatic Update

[Service]
Type=simple
ExecStart=distrobox\-upgrade \-\-all
StandardOutput=null
.EE
.PP
\[ti]/.config/systemd/user/distrobox\-upgrade.timer
.IP
.EX
[Unit]
Description=distrobox\-upgrade Automatic Update Trigger

[Timer]
OnBootSec=1h
OnUnitInactiveSec=1d

[Install]
WantedBy=timers.target
.EE
.PP
سپس کافی است دستور زیر را اجرا کنید:
\f[CR]systemctl \-\-user daemon\-reload && systemctl \-\-user enable \-\-now distrobox\-upgrade.timer\f[R]