2019-01-02 22:16:34 +00:00
---
title: Steps to a Successful Release
2019-12-11 09:49:28 +00:00
category: Contributing
2019-12-11 16:01:46 +00:00
layout: default
2021-09-14 14:05:21 +00:00
SPDX-License-Identifier: LGPL-2.1-or-later
2019-01-02 22:16:34 +00:00
---
2018-11-29 10:09:09 +00:00
# Steps to a Successful Release
2016-05-31 17:43:41 +00:00
1. Add all items to NEWS
2022-04-12 10:05:53 +00:00
2. Update the contributors list in NEWS (`ninja -C build git-contrib`)
2016-05-31 17:43:41 +00:00
3. Update the time and place in NEWS
2022-04-12 10:33:33 +00:00
4. Update hwdb (`ninja -C build update-hwdb`, `ninja -C build update-hwdb-autosuspend` , commit separately).
2022-05-05 17:49:26 +00:00
5. Update syscall numbers (`ninja -C build update-syscall-tables update-syscall-header`).
2022-04-12 10:33:33 +00:00
6. [RC1] Update version and library numbers in `meson.build`
2023-01-24 12:34:00 +00:00
7. Check dbus docs with `ninja -C build update-dbus-docs`
2023-01-24 13:30:02 +00:00
8. Update translation strings (`cd build`, `meson compile systemd-pot` , `meson compile systemd-update-po` ) - drop the header comments from `systemd.pot` + re-add SPDX before committing. If the only change in a file is the 'POT-Creation-Date' field, then ignore that file.
2023-01-24 12:34:00 +00:00
9. Tag the release: `version=vXXX-rcY && git tag -s "${version}" -m "systemd ${version}"`
10. Do `ninja -C build`
11. Make sure that the version string and package string match: `build/systemctl --version`
2023-10-09 19:28:27 +00:00
12. [FINAL] Close the github milestone and open a new one (https://github.com/systemd/systemd/milestones)
13. "Draft" a new release on github (https://github.com/systemd/systemd/releases/new), mark "This is a pre-release" if appropriate.
14. Check that announcement to systemd-devel, with a copy& paste from NEWS, was sent. This should happen automatically.
2023-11-14 20:18:50 +00:00
15. Update IRC topic (`/msg chanserv TOPIC #systemd Version NNN released | Online resources https://systemd.io/`)
2023-12-06 21:07:42 +00:00
16. [FINAL] Push commits to stable, create an empty -stable branch: `git push systemd-stable --atomic origin/main:main origin/main:refs/heads/${version}-stable` .
17. [FINAL] Build and upload the documentation (on the -stable branch): `ninja -C build doc-sync`
2023-10-09 16:43:31 +00:00
18. [FINAL] Change the default branch to latest release (https://github.com/systemd/systemd-stable/settings/branches).
19. [FINAL] Change the Github Pages branch in the stable repository to the newly created branch (https://github.com/systemd/systemd-stable/settings/pages) and set the 'Custom domain' to 'systemd.io'