Current File : //www/varak.net/nextcloud.varak.net/core/doc/admin/release_schedule.html
<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Maintenance and release schedule — Nextcloud latest Administration Manual latest documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
<link rel="stylesheet" type="text/css" href="_static/copybutton.css?v=76b2166b" />
<link rel="stylesheet" type="text/css" href="_static/dark_mode_css/general.css?v=c0a7eb24" />
<link rel="stylesheet" type="text/css" href="_static/dark_mode_css/dark.css?v=70edf1c7" />
<link rel="stylesheet" href="_static/custom.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="_static/jquery.js?v=5d32c60e"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="_static/documentation_options.js?v=c6e86fd7"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/clipboard.min.js?v=a7894cd8"></script>
<script src="_static/copybutton.js?v=f281be69"></script>
<script src="_static/dark_mode_js/default_light.js?v=c2e647ce"></script>
<script src="_static/dark_mode_js/theme_switcher.js?v=358d3910"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Installation and server configuration" href="installation/index.html" />
<link rel="prev" title="Upgrade to Nextcloud 26" href="release_notes/upgrade_to_26.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="contents.html">
<img src="_static/logo-white.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="index.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="release_notes/index.html">Release notes</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Maintenance and release schedule</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#overview">Overview</a></li>
<li class="toctree-l2"><a class="reference internal" href="#release-types">Release types</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#major-releases">Major releases</a></li>
<li class="toctree-l3"><a class="reference internal" href="#maintenance-releases">Maintenance releases</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#release-schedule">Release schedule</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#length-of-support-maintenance">Length of support (“maintenance”)</a></li>
<li class="toctree-l3"><a class="reference internal" href="#end-of-life">End-of-life</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#installation-version">Installation version</a></li>
<li class="toctree-l2"><a class="reference internal" href="#release-channels">Release channels</a></li>
<li class="toctree-l2"><a class="reference internal" href="#major-version-upgrades">Major version upgrades</a></li>
<li class="toctree-l2"><a class="reference internal" href="#beta-releases-and-release-candidates">Beta releases and Release candidates</a></li>
<li class="toctree-l2"><a class="reference internal" href="#downgrading">Downgrading</a></li>
<li class="toctree-l2"><a class="reference internal" href="#bug-reporting">Bug reporting</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="installation/index.html">Installation and server configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration_server/index.html">Nextcloud configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="apps_management.html">Apps management</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration_user/index.html">User management</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration_files/index.html">File sharing and management</a></li>
<li class="toctree-l1"><a class="reference internal" href="file_workflows/index.html">Flow</a></li>
<li class="toctree-l1"><a class="reference internal" href="groupware/index.html">Groupware</a></li>
<li class="toctree-l1"><a class="reference internal" href="office/index.html">Office</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference management</a></li>
<li class="toctree-l1"><a class="reference internal" href="ai/index.html">Artificial Intelligence</a></li>
<li class="toctree-l1"><a class="reference internal" href="webhook_listeners/index.html">Webhook Listeners</a></li>
<li class="toctree-l1"><a class="reference internal" href="windmill_workflows/index.html">Windmill Workflows</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration_database/index.html">Database configuration</a></li>
<li class="toctree-l1"><a class="reference internal" href="configuration_mimetypes/index.html">Mimetypes management</a></li>
<li class="toctree-l1"><a class="reference internal" href="maintenance/index.html">Maintenance</a></li>
<li class="toctree-l1"><a class="reference internal" href="issues/index.html">Issues and troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="gdpr/index.html">GDPR-compliance</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="contents.html">Nextcloud latest Administration Manual</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content style-external-links">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="contents.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item active">Maintenance and release schedule</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/nextcloud/documentation/edit/master/admin_manual/release_schedule.rst" class="fa fa-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="maintenance-and-release-schedule">
<h1>Maintenance and release schedule<a class="headerlink" href="#maintenance-and-release-schedule" title="Link to this heading"></a></h1>
<section id="overview">
<h2>Overview<a class="headerlink" href="#overview" title="Link to this heading"></a></h2>
<p>Nextcloud releases multiple major versions <em>throughout</em> the year, but maintains support for <em>each</em> major version for one full year each through “lighter” maintenance updates (and regularly <a class="reference external" href="https://en.wikipedia.org/wiki/Backporting">backporting</a> applicable security and bug fixes). This permits a high velocity development cadence, while still giving administrators flexibility when planning deployments, upgrades, and maintenance activities.</p>
<p>A detailed <a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">schedule for upcoming major and maintenance releases</a> (as well as end-of-life projections) is regularly updated to facilitate planning deployment, testing, and upgrade planning.</p>
<p>Whether you want the latest features and optimizations, want to help with testing, or just want to wait until everything is perfectly ready to go, you’ve got options with regards to which version of Nextcloud Server to initially deploy as well as how frequently to do major upgrades.</p>
<div class="admonition danger">
<p class="admonition-title">Danger</p>
<p>We always recommend installing the latest <strong>maintenance</strong> releases as soon as possible, regardless of which major version of Nextcloud Server you use. And we also always highly recommend upgrading from <strong>end-of-life</strong> releases as soon as possible.</p>
</div>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>Extended maintenance and additional support is available through <a class="reference external" href="https://nextcloud.com/enterprise/">subscriptions options for enterprise support</a> offered by Nextcloud developers through <a class="reference external" href="https://nextcloud.com">Nextcloud GmbH</a>.</p>
</div>
</section>
<section id="release-types">
<h2>Release types<a class="headerlink" href="#release-types" title="Link to this heading"></a></h2>
<p>Nextcloud has two types of releases in the default release channel:</p>
<ol class="arabic simple">
<li><p>Major releases</p></li>
<li><p>Maintenance releases</p></li>
</ol>
<p><strong>Major</strong> releases of Nextcloud Server (e.g. <code class="docutils literal notranslate"><span class="pre">28.X.X</span></code>) introduce new features and functionality.</p>
<p>Every major release is, in turn, supported for <em>one year</em> via periodic <strong>maintenance</strong> releases (e.g. <code class="docutils literal notranslate"><span class="pre">X.X.4</span></code>), which correct critical bugs and security vulnerabilities.</p>
<section id="major-releases">
<h3>Major releases<a class="headerlink" href="#major-releases" title="Link to this heading"></a></h3>
<p>Major releases usually introduce new features and often also include changes “under the hood”. These changes may be extensive.</p>
<p>A specific major release is indicated by the first part of the version string. For example, Nextcloud Server <code class="docutils literal notranslate"><span class="pre">28.0.4</span></code> is major release <code class="docutils literal notranslate"><span class="pre">28</span></code>. And <code class="docutils literal notranslate"><span class="pre">27.1.7</span></code> is major release <code class="docutils literal notranslate"><span class="pre">27</span></code>.</p>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>The highest numbered major release offers the latest features. While the lowest numbered major release offers the most time in the field.</p>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>You may need to meet new system requirements before the Updater will offer you a new major version. Even if offered, there may be other changes required that the Updater cannot check for fully. We try to highlight these, in each new edition of the Admin Manual, in the Critical changes section of the <em>Release notes</em> chapter.</p>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>Apps generally define their compatibility based on the major version(s) of Nextcloud Server they support. Consider the compatibility of your favorite and most critical apps, with a prospective major version of Nextcloud Server, before choosing which major version to deploy or deciding when to upgrade to a newly available major version. Also, since many apps are community provided and maintained by volunteers, you may want to offer to test the app against a new major version of Nextcloud (or to adapt it, if you’re in a position to do so) in order to encourage a faster (or higher quality) release.</p>
</div>
</section>
<section id="maintenance-releases">
<h3>Maintenance releases<a class="headerlink" href="#maintenance-releases" title="Link to this heading"></a></h3>
<p>Maintenance releases deliberately <strong>do not</strong> introduce new features or breaking changes. This is meant to reduce the risks and impact associated with deploying updates so that critical bugs or security vulnerabilities can be rapidly and routinely addressed.</p>
<p>Maintenance releases are published (generally simultaneously) for all stable major releases that have not reached end-of-life status.</p>
<p>These releases should not have app compatibility concerns or introduce changes requiring retraining end users.</p>
<p>A specific maintenance release is indicated by the last part of the version number. For example, <code class="docutils literal notranslate"><span class="pre">28.0.4</span></code> is the <em>fourth</em> maintenance release for major version <code class="docutils literal notranslate"><span class="pre">28</span></code> of Nextcloud Server. It offers fixes for any critical bugs and security vulnerabilities addressed since the last maintenance release (<code class="docutils literal notranslate"><span class="pre">28.0.3</span></code> in this example).</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>All critical bug fixes, including security related ones, are <a class="reference external" href="https://en.wikipedia.org/wiki/Backporting">backported</a> to <strong>all</strong> maintained major releases.</p>
</div>
</section>
</section>
<section id="release-schedule">
<h2>Release schedule<a class="headerlink" href="#release-schedule" title="Link to this heading"></a></h2>
<p>New <strong>major</strong> releases of Nextcloud Server are published approximiately every sixteen weeks.</p>
<p>New <strong>maintenance</strong> releases are published approximately every four weeks.</p>
<section id="length-of-support-maintenance">
<h3>Length of support (“maintenance”)<a class="headerlink" href="#length-of-support-maintenance" title="Link to this heading"></a></h3>
<p>Our release schedule means that several major releases (e.g. 26.X.X, 27.X.X, 28.X.X) are supported simultaneously. Whenever a critical bug or vulnerability is addressed, if it impacts more than one major release, it is <strong>backported</strong> to all applicable major releases and published in the next maintenance release (e.g. <code class="docutils literal notranslate"><span class="pre">28.0.3</span></code> -> <code class="docutils literal notranslate"><span class="pre">28.0.4</span></code>). Any major release that has not reached end-of-life status receives these maintenance updates.</p>
<p>This overlapping schedule and predictable cadence permits rapid development while giving administrators visibility, access to critical bug fixes, and flexibility as to how aggressively to upgrade to new majors.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Since every major release is supported for one year from initial release, the minimum you need to do to stay up-to-date is to install maintenance releases as they’re published and upgrade to the next higher up major release when the one you’re currently on reaches end-of-life status. Since maintenance releases only patch your Server with the latest bug and security vulnerability fixes - and do <strong>not</strong> introduce other significant changes - the risk of upgrading to a new maintenance release is far less than upgrading to a new major release.</p>
</div>
</section>
<section id="end-of-life">
<h3>End-of-life<a class="headerlink" href="#end-of-life" title="Link to this heading"></a></h3>
<p>End-of-life status means that support/maintenance ends. Maintenance releases cease for a major version on the one year anniversary of initial release. The major version then moves into end-of-life status and will not receive any further bug fixes or corrections for security vulnerabilities.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Support for major releases may be extended through <a class="reference external" href="https://nextcloud.com/enterprise/">subscription services for enterprises</a> offered by Nextcloud developers via <a class="reference external" href="https://nextcloud.com">Nextcloud GmbH</a>.</p>
</div>
<p>The end-of-life dates for all major releases are <a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">published</a> ahead of time to ease planning.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>As long as a major release is still listed on the <a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">maintenance schedule</a> as being <em>Currently Maintained</em>, you can expect to receive all relevant fixes for critical bugs or security vulnerabilities (even those made available for newer major releases, if they are relevant to a still supported earlier major).</p>
</div>
</section>
</section>
<section id="installation-version">
<h2>Installation version<a class="headerlink" href="#installation-version" title="Link to this heading"></a></h2>
<p>Since multiple major releases are published throughout the year and each is supported for a year with any relevant bug and security fixes, you have discretion as to which which major to deploy initially as well as when to upgrade to a new major.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>If you’re planning to deploy Nextcloud in an enterprise setting and your usage will be mission-critical, the developers can help you choose, via an <a class="reference external" href="https://nextcloud.com/enterprise/">Enterprise services arrangement</a>, the major version most suitable for your particular use case as well as help make sure it’s deployed optimally while addressing any critical problems that arise with you one-on-one.</p>
</div>
</section>
<section id="release-channels">
<h2>Release channels<a class="headerlink" href="#release-channels" title="Link to this heading"></a></h2>
<p>By default all Nextcloud installations utilize the <code class="docutils literal notranslate"><span class="pre">stable</span></code> release channel. This channel delivers the latest features that are ready for most users at minimal risk.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Nextcloud does staged roll-outs of new releases to further reduce the risk of widespread updates. New releases, particularly major releases, are usually only made available to a small percentage of systems initially. After a week (or more) has passed with no reported widespread critical bugs, more systems will be offered the update. Sometimes major versions are limited to <100% of systems until after the first maintenance (bug fix) release has been published.</p>
</div>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>When using the <code class="docutils literal notranslate"><span class="pre">stable</span></code> channel it is possible you’ll be <em>offered</em> a newer major version to upgrade to <em>even if</em> your existing major version has <strong>not</strong> reached end-of-life. It is up to you to decide whether to upgrade then or wait until a better time for deploying a major new release. On the other hand, new <strong>maintenance</strong> releases (within the major version you’re already running) should be deployed as soon as possible to keep up-to-date with security and other critical bug fixes.</p>
</div>
<div class="admonition danger">
<p class="admonition-title">Danger</p>
<p>Making sure you’re running an actively maintained <strong>major</strong> release is critical. Once a major release reaches End of Life status it will not receive any further maintenance releases to correct critical bugs or vulnerabilities.</p>
</div>
<p>You can find the detailed schedule for all stable channel major releases and maintenance releases, including end-of-life dates, in our regularly updated <a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">Maintenance and Release Schedule</a>.</p>
</section>
<section id="major-version-upgrades">
<h2>Major version upgrades<a class="headerlink" href="#major-version-upgrades" title="Link to this heading"></a></h2>
<p>Before upgrading from one one major release to another, we strongly recommend reviewing the <em>Critical changes</em> section of the <strong>Release Notes</strong> chapter to minimize the chance of introducing unexpected breaking changes in your environment.</p>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<p>Having good data backups (and a tested data restore approach!) is recommendeded in general, but definitely before performing an update - whether major or merely maintenance.</p>
</div>
</section>
<section id="beta-releases-and-release-candidates">
<h2>Beta releases and Release candidates<a class="headerlink" href="#beta-releases-and-release-candidates" title="Link to this heading"></a></h2>
<p>Before a new final major release is published, typically at least four beta releases are published followed by two release candidates, with an interval of one week between each.</p>
<p>Before a new final maintenance release is published, one release candidate is published approximately one week beforehand.</p>
<p>Anticipated dates for each release can be found on <a class="reference external" href="https://github.com/nextcloud/server/wiki/Maintenance-and-Release-Schedule">detailed schedule</a>.</p>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>To update sooner to a new major version or beta version, you may at your discretion adjust your instance to use the <code class="docutils literal notranslate"><span class="pre">beta</span></code> channel. Around big releases the <code class="docutils literal notranslate"><span class="pre">beta</span></code> channel also delivers the newest major version earlier regardless of staging parameters.</p>
</div>
<p>Everyone in the community benefits considerably from the generous testing and feedback of those that choose to evaluate beta releases or release candidates in either their test environments or, for the bold, under real-world conditions.</p>
<p>If you are in a position to evaluate a pre-final release, the developers and the entire community thank you!</p>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>We suggest focusing your testing efforts on verifying the functionality and features you rely on every day (to make sure these operate as expected). Then, if you are so inclined, to consider evaluating any new functionality that interests you. Please discuss problems that arise at the <a class="reference external" href="https://help.nextcloud.com">Help Forum</a> and report suspected bugs to <a class="reference external" href="https://github.com/nextcloud/server/issues">the GitHub repository</a>.</p>
</div>
</section>
<section id="downgrading">
<h2>Downgrading<a class="headerlink" href="#downgrading" title="Link to this heading"></a></h2>
<p>Downgrading is not supported officially between any major, maintenance, or pre-release version.</p>
</section>
<section id="bug-reporting">
<h2>Bug reporting<a class="headerlink" href="#bug-reporting" title="Link to this heading"></a></h2>
<p>Before reporting bugs, please make sure you’re running a still supported major release <em>and</em> the latest maintenance release for it.</p>
<div class="admonition tip">
<p class="admonition-title">Tip</p>
<p>Nextcloud GmbH - which employs many of the core developers - offers <a class="reference external" href="https://nextcloud.com/enterprise/">Nextcloud Enterprise services</a> providing direct access to Nextcloud engineering expertise where usage is mission-critical. Among other things, they can help you choose the major version most appropriate to your use case (and make sure it’s deployed optimally).</p>
</div>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="release_notes/upgrade_to_26.html" class="btn btn-neutral float-left" title="Upgrade to Nextcloud 26" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="installation/index.html" class="btn btn-neutral float-right" title="Installation and server configuration" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>© Copyright 2024 Nextcloud GmbH.</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="Versions">
<span class="rst-current-version" data-toggle="rst-current-version">
<span class="fa fa-book"> Read the Docs</span>
v: latest
<span class="fa fa-caret-down"></span>
</span>
<div class="rst-other-versions">
<dl>
<dt>Versions</dt>
<dd><a href="https://docs.nextcloud.com/server/28/admin_manual">28</a></dd>
<dd><a href="https://docs.nextcloud.com/server/29/admin_manual">29</a></dd>
<dd><a href="https://docs.nextcloud.com/server/stable/admin_manual">stable</a></dd>
<dd><a href="https://docs.nextcloud.com/server/latest/admin_manual">latest</a></dd>
</dl>
<dl>
<dt>Downloads</dt>
</dl>
<dl>
<dt>On Read the Docs</dt>
<dd>
<a href="///projects//?fromdocs=">Project Home</a>
</dd>
<dd>
<a href="///builds//?fromdocs=">Builds</a>
</dd>
</dl>
</div>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>
Mini Shell