Issues - Calamares

<!doctype html>  <html lang="en" class="no-js"> <head> <meta charset="utf-8"> <title>Issues - Calamares</title> <meta name="description" content="The idea of Calamares arose from a desire of several independent Linux distributions to come together and work on a shared system installer. Instead of everyone working on their own implementation and forking forks of forks, why not work together on something that can be used by many?"> <meta property="og:type" content="website"> <meta property="og:locale" content="en_US"> <meta property="og:site_name" content="Calamares"> <meta property="og:title" content="Issues"> <meta property="og:url" content="https://calamares.io/issues/"> <meta property="og:description" content="The idea of Calamares arose from a desire of several independent Linux distributions to come together and work on a shared system installer. Instead of everyone working on their own implementation and forking forks of forks, why not work together on something that can be used by many?"> <meta property="og:image" content="https://calamares.io/images/banner.webp"> <link rel="canonical" href="https://calamares.io/issues/"> <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Person", "name": "Calamares", "url": "https://calamares.io/" } </script>  <link href="/feed.xml" type="application/atom+xml" rel="alternate" title="Calamares Feed">  <meta name="viewport" content="width=device-width, initial-scale=1.0"> <script> document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js '; </script>  <link rel="stylesheet" href="/assets/css/main.css"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css">     </head> <body class="layout--single"> <nav class="skip-links"> <h2 class="screen-reader-text">Skip links</h2> <ul> <li><a href="#site-nav" class="screen-reader-shortcut">Skip to primary navigation</a></li> <li><a href="#main" class="screen-reader-shortcut">Skip to content</a></li> <li><a href="#footer" class="screen-reader-shortcut">Skip to footer</a></li> </ul> </nav>  <div class="masthead"> <div class="masthead__inner-wrap"> <div class="masthead__menu"> <nav id="site-nav" class="greedy-nav"> <a class="site-logo" href="/"><img src="https://raw.githubusercontent.com/calamares/calamares/calamares/src/branding/default/squid.png" alt=""></a> <a class="site-title" href="/"> Calamares <span class="site-subtitle">The universal installer framework</span> </a> <ul class="visible-links"><li class="masthead__menu-item"> <a href="/news/"><i class='fas fa-newspaper'></i> News</a> </li><li class="masthead__menu-item"> <a href="/about/"><i class='fas fa-sitemap'></i> About</a> </li><li class="masthead__menu-item"> <a href="https://github.com/calamares/calamares"><i class='fab fa-github'></i> Code</a> </li><li class="masthead__menu-item"> <a href="/issues/"><i class='fas fa-bug'></i> Issues</a> </li><li class="masthead__menu-item"> <a href="https://github.com/calamares/calamares/wiki"><i class='fas fa-graduation-cap'></i> Wiki</a> </li><li class="masthead__menu-item"> <a href="/docs/users-guide/"><i class='fas fa-book'></i> Guide</a> </li></ul> <button class="greedy-nav__toggle hidden" type="button"> <span class="visually-hidden">Toggle menu</span> <div class="navicon"></div> </button> <ul class="hidden-links hidden"></ul> </nav> </div> </div> </div> <div class="initial-content"> <div class="page__hero--overlay" style="background-color: #000; background-image: linear-gradient(rgba(0, 0, 0, 0.8), rgba(0, 0, 0, 0.8)), url('/images/banner.webp');" > <div class="wrapper"> <h1 id="page-title" class="page__title" itemprop="headline"> Issues </h1> </div> </div> <div id="main" role="main"> <div class="sidebar sticky"> <nav class="nav__list"> <input id="ac-toc" name="accordion-toc" type="checkbox" /> <label for="ac-toc">Toggle menu</label> <ul class="nav__items"> <li> <a href="https://github.com/calamares/calamares/releases"><span class="nav__sub-title"><i class='fas fa-download fa-2x'></i> Download</span></a> </li> <li> <span class="nav__sub-title"><i class='fas fa-stream fa-2x'></i> Documents</span> <ul> <li><a href="https://github.com/calamares/calamares/wiki/Deploy-Guide">Deploy Guide</a></li> <li><a href="https://github.com/calamares/calamares/blob/calamares/CONTRIBUTING.md#dependencies">Dependencies</a></li> <li><a href="https://github.com/calamares/calamares/blob/calamares/src/branding/README.md">Branding</a></li> <li><a href="https://github.com/calamares/calamares/blob/calamares/src/modules/README.md">Modules</a></li> <li><a href="https://github.com/calamares/calamares-extensions">Extensions</a></li> </ul> </li> <li> <a href="/team/"><span class="nav__sub-title"><i class='fas fa-users-cog fa-2x'></i> Team</span></a> </li> <li> <a href="https://www.transifex.com/calamares/calamares/"><span class="nav__sub-title"><i class='fas fa-globe fa-2x'></i> Translate</span></a> </li> <li> <a href="https://webchat.kde.org/#/room/%23calamares:kde.org"><span class="nav__sub-title"><i class='fas fa-comments fa-2x'></i> Talk</span></a> </li> </ul> </nav> </div> <article class="page" itemscope itemtype="https://schema.org/CreativeWork"> <meta itemprop="headline" content="Issues"> <div class="page__inner-wrap"> <section class="page__content" itemprop="text"> <aside class="sidebar__right "> <nav class="toc"> <header><h4 class="nav__title"><i class="fas fa-file-alt"></i> Content</h4></header> <ul class="toc__menu"> <li><a href="#developers-of-distributions">Developers of Distributions</a></li> <li><a href="#end-users">End Users</a></li> </ul> </nav> </aside> <p>Getting bugs fixed is an important, if not crucial part of the quality assurance for any project. To solve issues, the quality of bug reports is important. When reporting try to include:</p> <ul> <li>Name of Distribution used <ul> <li>version of the Distribution</li> <li>if possible, link to the ISO file</li> <li>if it is your own distro, or doesn’t have releases yet, put an ISO up on a file-sharing site somewhere.</li> </ul> </li> <li>Version of Calamares used (released version or git build) <ul> <li>the Calamares version can be seen in the log file, or in the <em>About</em> dialog on the welcome page</li> <li>if possible, also the KPMCore version from your package manager.</li> </ul> </li> <li>Logs & Screenshots <ul> <li>The Calamares session log is placed in <code class="language-plaintext highlighter-rouge">~/.cache/calamares</code> and is called <code class="language-plaintext highlighter-rouge">session.log</code>. It is placed in the home-directory of the user <strong>running</strong> Calamares, so that may be the root user. If it is not detailed, add <code class="language-plaintext highlighter-rouge">-D6</code> to the flags passed to Calamares (meaning “debug logging level 6”, which is plenty).</li> <li>Screenshots can also be photos, if no suitable screenshot / internet connection is available.</li> </ul> </li> <li>Use the ISSUE_TEMPLATE provided for you when opening an issue.</li> </ul> <p>The place where to report bugs, issues, errors or feature request:<br /> <a href="https://github.com/calamares/calamares/issues" target="_blank"><strong>Calamares Issues</strong></a> (On GitHub).</p> <h2 class="offset" id="developers-of-distributions">Developers of Distributions</h2> <p>If you are a developer of a distribution and are new to Calamares, make sure to thoroughly read the Wiki pages provided for you. See the links on the left. Reporting issues is for bugs, errors, issues you may have found, or adding a new feature request. Issues are <strong>NOT</strong> a help channel. If you have questions left after reading the Wiki, use the Matrix channel to get help.</p> <p>When reporting an issue or feature request, include as many of the following as possible (in addition to the info requested above):</p> <ul> <li>Installation log</li> <li>Link to an ISO of your distribution</li> <li>Link to the settings.conf used</li> <li>List custom modules used (not part of upstream Calamares)</li> <li>Detailed description of how to duplicate the error/issue found</li> <li>Version used of GCC (or other compiler), KPMCore, CMake & Qt</li> </ul> <h2 class="offset" id="end-users">End Users</h2> <p>Most of the time, Calamares issues is not the place for you to report issues. Use the bug tracker of your distribution instead. Every distribution has their own implementation of Calamares and they can much better decide if the issue found is distribution specific or a general Calamares issue.</p> <p>If you decide it is a general Calamares issue, make sure to include all information requested in the first section. In addition provide:</p> <ul> <li>Is the issue related to a BIOS or UEFI system install?</li> <li>Are you using a GPT or msdos partition table?</li> <li>Try to find out from your distribution where they locate the installation.log and provide that log</li> <li>Many time disk layout used is needed, provide the needed info with <code class="language-plaintext highlighter-rouge">sudo blkid</code> and <code class="language-plaintext highlighter-rouge">sudo fdisk -l</code></li> </ul> <hr /> <p>Calamares is a community project.</p> </section> <footer class="page__meta"> </footer> </div> </article> </div> </div> <div id="footer" class="page__footer"> <footer>   <div class="page__footer-follow"> <ul class="social-icons"> <li><strong>Follow:</strong></li> <li><a href="https://github.com/calamares/calamares" rel="nofollow noopener noreferrer" target="_blank"><i class="fab fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li> <li><a href="https://webchat.kde.org/#/room/%23calamares:kde.org" rel="nofollow noopener noreferrer" target="_blank"><i class="far fa-comments" aria-hidden="true"></i> Matrix</a></li> <li><a href="/feed.xml"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li> </ul> </div> <aside class="back_to__top"> <a href="#site-nav"> <i class="fas fa-angle-double-up fa-2x"></i></a> </aside> <div class="page__footer-copyright">© 2014 - 2025 . All trademarks and registered trademarks are the property of their respective owners. Calamares is a community project..</div> </footer> </div> <script src="/assets/js/main.min.js"></script> </body> </html>

CINXE.COM

Issues - Calamares