rails_error_dashboard 0.16.0 → 0.16.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84ad49626b8dddc0665ed515f3fc8e3357adadddcb5991679324cffa40d2aa2e
-  data.tar.gz: af06a63fb80ded2960e23f6e6c25ace1a741b85e13f014ae4bfbfd4b4b16980a
+  metadata.gz: 5e1c8b34bf48e03bc9b163397dc1acbe54d0900b539805159c3361b74e5aad2c
+  data.tar.gz: 5940d53e5b99cf6fbac71597f09e20275026b49f3e09e3699d51aa50c1eac615
 SHA512:
-  metadata.gz: c3154ebfa3b1d46d497a86cfca33dca5a09ed98127a699e7a9eb17ce3d05380f807172b377a2a824fbffff806e6f1e9a6c6ba96e8cb61802368e81ffc56ea93a
-  data.tar.gz: 571ca72a5e588371357a427c02a2ebed3bf565cf70f03b8c8e5877245e060bd7d8ddff873ae50235ac1c4103c6944d4f5e852c221766f7292225b4af8406ceca
+  metadata.gz: bd17c0b7c07fb32bcdd872c677c738f6c6d48caa1a12e8024943f5470cc22a58fbfef647d400b6badf69ee2c6aacdcfe1c739bbf00b84c2ff5e15ae55f2598c7
+  data.tar.gz: 5702dd3b52bda8e361d0ff2ef4ecac9835865b6572030c0f56fba735b9b4c7e84b9098fe576d2614ed45c25fe2020f8c8b9762adf8f1e74e4ef653e191a70168

data/README.md

@@ -127,7 +127,7 @@ No RED licence or event-ingestion fee, and no plan limits — your database is t
 - **Host-app safety** — nothing in the capture path raises into your app; every subscriber and callback is rescue-wrapped, `Thread.current` is cleaned up in `ensure`, and the original exception is always re-raised. Variables, health and breadcrumbs are opt-in and off by default; storm protection is on by default and fails open.
 - **Performance** — the storm-protection hot path is a digest plus an atomic increment with no I/O; the figures quoted below are a maintainer's single-machine measurements and no benchmark script ships with the gem yet.
 - **Security** — HTTP Basic Auth or your own `authenticate_with` lambda (Devise, Warden, session); your Rails `filter_parameters` are applied to params, variables and breadcrumbs; prompts are never recorded by LLM observability. Vulnerability reports: [SECURITY.md](SECURITY.md).
-- **Compatibility** — Rails 7.0–8.1, Ruby 3.2–4.0, PostgreSQL, MySQL/Trilogy or SQLite; `turbo-rails` plus ActionCable are needed for live updates (no polling fallback); the gem's own CSS/JS is inline but Bootstrap JS, Chart.js, highlight.js and Google Fonts load from CDNs, so it is not air-gap clean.
+- **Compatibility** — Rails 7.0–8.1 (on Rails 7.0.0 to 7.0.8.7, unhandled request errors are not recorded; Rails 7.0.10 fixes it), Ruby 3.2–4.0, PostgreSQL, MySQL/Trilogy or SQLite; `turbo-rails` plus ActionCable are needed for live updates (no polling fallback); the gem's own CSS/JS is inline but Bootstrap JS, Chart.js, highlight.js and Google Fonts load from CDNs, so it is not air-gap clean.
 
 ---
 
@@ -632,6 +632,7 @@ gem 'rails_error_dashboard'
 
 RED requires Rails 7.0 or newer, Ruby 3.2 or newer, `pagy ~> 43` and `groupdate ~> 6`. An app that pins an older Pagy or groupdate must upgrade it first, or `bundle install` fails.
 
+- **Rails 7.0.0 to 7.0.8.7**: unhandled exceptions from web requests are not recorded, because these versions render the error page without reporting the exception. Upgrade to Rails 7.0.10 or later, which reports them; until then RED logs a warning at boot. See [Troubleshooting](docs/TROUBLESHOOTING.md#request-errors-not-recorded-on-rails-70).
 - **Rails before 8.1.4 or 7.2.4** (every 8.0, 7.1 and 7.0 release): also add `gem "json", "< 3"`. json 3 breaks those Rails versions, and the dashboard returns 500. See [the json pin](docs/UPGRADING.md#rails-before-814-or-724-pin-json-below-3).
 - **MySQL**: load the time-zone tables (`mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql`), or the charts fail.
 

data/app/views/rails_error_dashboard/errors/correlation.html.erb

@@ -109,7 +109,7 @@
                   <td><%= release[:error_types] %></td>
                   <td>
                     <% release[:platforms].each do |platform| %>
-                      <span class="badge bg-secondary text-capitalize me-1"><%= platform %></span>
+                      <span class="badge bg-secondary me-1"><%= platform %></span>
                     <% end %>
                   </td>
                   <td>
@@ -326,7 +326,7 @@
         <div class="row">
           <% @platform_specific_errors.each do |platform, errors| %>
             <div class="col-md-6 mb-3">
-              <h6 class="text-capitalize"><%= platform %></h6>
+              <h6><%= platform %></h6>
               <div class="list-group">
                 <% errors.each do |error_data| %>
                   <div class="list-group-item">

data/app/views/rails_error_dashboard/errors/overview.html.erb

@@ -211,6 +211,10 @@
                 <div class="progress" style="height: 4px; margin-bottom: var(--space-3);">
                   <div class="progress-bar" style="width: <%= health[:stability_score] %>%; background: var(--status-<%= health[:health_status] == :healthy ? 'success' : health[:health_status] == :warning ? 'warning' : 'critical' %>);"></div>
                 </div>
+                <%# Scored on volume alone: nothing from the window is resolved %>
+                <% unless health[:resolution_measured] %>
+                  <div style="font-size: 12px; color: var(--text-tertiary); margin-bottom: var(--space-2);"><%= red_t("red.common.health_status.nothing_resolved") %></div>
+                <% end %>
               <% end %>
               <div style="font-size: 12px; color: var(--text-tertiary);">
                 <%= red_t("red.errors.overview_page.platform_summary", total: health[:total_errors], critical: health[:critical_errors], unresolved: health[:unresolved_errors]) %>

data/app/views/rails_error_dashboard/errors/platform_comparison.html.erb

@@ -38,7 +38,7 @@
         <div class="col-md-6 col-lg-3 mb-3">
           <div class="card h-100 <%= { healthy: 'border-success', warning: 'border-warning', not_rated: 'border-secondary' }.fetch(health[:health_status], 'border-danger') %>">
             <div class="card-body">
-              <h5 class="card-title text-capitalize">
+              <h5 class="card-title">
                 <%= platform || red_t("red.common.unknown") %>
                 <% if health[:health_status] == :healthy %>
                   <span class="badge bg-success float-end"><%= red_t("red.analytics.platform_comparison.health_card.healthy") %></span>
@@ -64,6 +64,10 @@
                          style="width: <%= health[:stability_score] %>%">
                     </div>
                   </div>
+                  <%# Scored on volume alone: nothing from the window is resolved %>
+                  <% unless health[:resolution_measured] %>
+                    <small class="text-muted d-block mt-1"><%= red_t("red.common.health_status.nothing_resolved") %></small>
+                  <% end %>
                 </div>
               <% end %>
 
@@ -139,7 +143,7 @@
           <div class="card-body">
             <% @severity_distribution.each do |platform, severities| %>
               <div class="mb-3">
-                <h6 class="text-capitalize"><%= platform || red_t("red.common.unknown") %></h6>
+                <h6><%= platform || red_t("red.common.unknown") %></h6>
                 <% total = severities.values.sum %>
                 <% if total > 0 %>
                   <div class="progress" style="height: 25px;">
@@ -239,7 +243,7 @@
                     </td>
                     <td>
                       <% error[:platforms].each do |platform| %>
-                        <span class="badge bg-secondary text-capitalize me-1"><%= platform %></span>
+                        <span class="badge bg-secondary me-1"><%= platform %></span>
                       <% end %>
                     </td>
                     <td>
@@ -318,7 +322,7 @@
     new Chart(errorRateCtx, {
       type: 'bar',
       data: {
-        labels: <%= js_safe_json(@error_rate_by_platform.keys.map { |k| k.to_s.capitalize }) %>,
+        labels: <%= js_safe_json(@error_rate_by_platform.keys.map(&:to_s)) %>,
         datasets: [{
           label: '<%= red_js_t("red.ui_js.charts.series_total_errors") %>',
           data: <%= js_safe_json(@error_rate_by_platform.values) %>,
@@ -345,7 +349,7 @@
   if (dailyTrendCtx) {
     const datasets = <%= js_safe_json(@daily_trends.map { |platform, data|
       {
-        label: platform.to_s.capitalize,
+        label: platform.to_s,
         data: data.values,
         platform: platform.to_s.downcase,
         tension: 0.4
@@ -382,7 +386,7 @@
   // Resolution Time Chart
   const resolutionTimeCtx = document.getElementById('resolutionTimeChart');
   if (resolutionTimeCtx) {
-    const platforms = <%= js_safe_json(@resolution_times.keys.map { |k| k.to_s.capitalize }) %>;
+    const platforms = <%= js_safe_json(@resolution_times.keys.map(&:to_s)) %>;
     const times = <%= js_safe_json(@resolution_times.values.map { |v| v || 0 }) %>;
 
     new Chart(resolutionTimeCtx, {

data/config/locales/de.yml

@@ -38,6 +38,7 @@ de:
         critical: "\U0001F534 Kritisch"
         not_rated: "Nicht bewertet"
         not_rated_hint: "Eine Bewertung vergleicht Plattformen und braucht daher Fehler auf mindestens zwei."
+        nothing_resolved: "Noch keine Fehler aus diesem Zeitraum behoben"
       device_type:
         mobile: Mobil
         tablet: Tablet
@@ -349,7 +350,7 @@ de:
         types:
           business_hours:
             label: Muster der Geschäftszeiten
-            description: Fehler häufen sich während der Geschäftszeiten (9–17 Uhr),
+            description: Fehler häufen sich während der Geschäftszeiten (9:00–17:59),
               was auf einen Zusammenhang mit der Nutzeraktivität hindeutet
           night:
             label: Nachtmuster

data/config/locales/en.yml

@@ -84,6 +84,7 @@ en:
         critical: "🔴 Critical"
         not_rated: "Not rated"
         not_rated_hint: "A rating compares platforms, so it needs errors on at least two."
+        nothing_resolved: "No errors from this period resolved yet"
 
       # Device classes reported by the user-agent parser. Browser and OS names
       # (Chrome, Safari, Windows, iOS) are brands and stay as written; these
@@ -520,7 +521,7 @@ en:
         types:
           business_hours:
             label: "Business Hours Pattern"
-            description: "Errors peak during business hours (9am-5pm), suggesting user activity correlation"
+            description: "Errors peak during business hours (9:00–17:59), suggesting user activity correlation"
           night:
             label: "Night Pattern"
             description: "Errors peak during night hours (midnight-6am), possibly from background jobs or automated tasks"

data/config/locales/es.yml

@@ -38,6 +38,7 @@ es:
         critical: "\U0001F534 Crítico"
         not_rated: "Sin calificar"
         not_rated_hint: "La calificación compara plataformas, así que necesita errores en al menos dos."
+        nothing_resolved: "Aún no se ha resuelto ningún error de este período"
       device_type:
         mobile: Móvil
         tablet: Tableta
@@ -363,7 +364,7 @@ es:
         types:
           business_hours:
             label: Patrón de horario laboral
-            description: Los errores se concentran en el horario laboral (9:00-17:00),
+            description: Los errores se concentran en el horario laboral (9:00–17:59),
               lo que sugiere relación con la actividad de los usuarios
           night:
             label: Patrón nocturno

data/config/locales/fr.yml

@@ -38,6 +38,7 @@ fr:
         critical: "\U0001F534 Critique"
         not_rated: "Non évalué"
         not_rated_hint: "L'évaluation compare les plateformes : il faut des erreurs sur au moins deux."
+        nothing_resolved: "Aucune erreur de cette période n'est encore résolue"
       device_type:
         mobile: Mobile
         tablet: Tablette
@@ -364,7 +365,7 @@ fr:
         types:
           business_hours:
             label: Motif des heures ouvrées
-            description: Les erreurs culminent pendant les heures ouvrées (9h-17h),
+            description: Les erreurs culminent pendant les heures ouvrées (9:00–17:59),
               ce qui suggère un lien avec l'activité des utilisateurs
           night:
             label: Motif nocturne

data/config/locales/it.yml

@@ -38,6 +38,7 @@ it:
         critical: "\U0001F534 Critico"
         not_rated: "Non valutato"
         not_rated_hint: "La valutazione confronta le piattaforme, quindi servono errori su almeno due."
+        nothing_resolved: "Nessun errore di questo periodo è stato ancora risolto"
       device_type:
         mobile: Mobile
         tablet: Tablet
@@ -358,7 +359,7 @@ it:
         types:
           business_hours:
             label: Schema da orario d'ufficio
-            description: Il picco di errori cade nell'orario d'ufficio (9–17), il
+            description: Il picco di errori cade nell'orario d'ufficio (9:00–17:59), il
               che suggerisce una correlazione con l'attività degli utenti
           night:
             label: Schema notturno

data/config/locales/ja.yml

@@ -38,6 +38,7 @@ ja:
         critical: "\U0001F534 重大"
         not_rated: "評価なし"
         not_rated_hint: "評価はプラットフォーム同士の比較なので、2つ以上のプラットフォームのエラーが必要です。"
+        nothing_resolved: "この期間のエラーはまだ1件も解決されていません"
       device_type:
         mobile: モバイル
         tablet: タブレット
@@ -325,7 +326,7 @@ ja:
         types:
           business_hours:
             label: 業務時間帯パターン
-            description: エラーは業務時間帯(9時〜17時)に集中しており、ユーザーの利用状況との関連が考えられます
+            description: エラーは業務時間帯(9:00–17:59)に集中しており、ユーザーの利用状況との関連が考えられます
           night:
             label: 夜間パターン
             description: エラーは夜間(0時〜6時)に集中しており、バックグラウンドジョブや自動処理が原因の可能性があります

data/config/locales/pl.yml

@@ -38,6 +38,7 @@ pl:
         critical: "\U0001F534 Krytyczny"
         not_rated: "Bez oceny"
         not_rated_hint: "Ocena porównuje platformy, więc potrzebne są błędy na co najmniej dwóch."
+        nothing_resolved: "Żaden błąd z tego okresu nie został jeszcze rozwiązany"
       device_type:
         mobile: Mobile
         tablet: Tablet
@@ -366,7 +367,7 @@ pl:
         types:
           business_hours:
             label: Wzorzec godzin pracy
-            description: Szczyt błędów przypada na godziny pracy (9:00–17:00), co
+            description: Szczyt błędów przypada na godziny pracy (9:00–17:59), co
               sugeruje związek z aktywnością użytkowników
           night:
             label: Wzorzec nocny

data/config/locales/pt-BR.yml

@@ -38,6 +38,7 @@ pt-BR:
         critical: "\U0001F534 Crítico"
         not_rated: "Sem avaliação"
         not_rated_hint: "A avaliação compara plataformas, então precisa de erros em pelo menos duas."
+        nothing_resolved: "Nenhum erro deste período foi resolvido ainda"
       device_type:
         mobile: Celular
         tablet: Tablet
@@ -363,7 +364,7 @@ pt-BR:
         types:
           business_hours:
             label: Padrão de horário comercial
-            description: Os erros se concentram no horário comercial (9h-17h), o que
+            description: Os erros se concentram no horário comercial (9:00–17:59), o que
               sugere relação com a atividade dos usuários
           night:
             label: Padrão noturno

data/config/locales/ru.yml

@@ -38,6 +38,7 @@ ru:
         critical: "\U0001F534 Критично"
         not_rated: "Без оценки"
         not_rated_hint: "Оценка сравнивает платформы, поэтому нужны ошибки как минимум на двух."
+        nothing_resolved: "Ни одна ошибка за этот период ещё не решена"
       device_type:
         mobile: Мобильное
         tablet: Планшет
@@ -368,7 +369,7 @@ ru:
         types:
           business_hours:
             label: Рабочие часы
-            description: Пик ошибок приходится на рабочие часы (9:00–17:00), что указывает
+            description: Пик ошибок приходится на рабочие часы (9:00–17:59), что указывает
               на связь с активностью пользователей
           night:
             label: Ночная закономерность

data/config/locales/uk.yml

@@ -38,6 +38,7 @@ uk:
         critical: "\U0001F534 Критичний"
         not_rated: "Без оцінки"
         not_rated_hint: "Оцінка порівнює платформи, тому потрібні помилки щонайменше на двох."
+        nothing_resolved: "Жодну помилку за цей період ще не вирішено"
       device_type:
         mobile: Mobile
         tablet: Tablet
@@ -366,7 +367,7 @@ uk:
         types:
           business_hours:
             label: Закономірність робочих годин
-            description: Пік помилок припадає на робочі години (9:00–17:00), що вказує
+            description: Пік помилок припадає на робочі години (9:00–17:59), що вказує
               на звʼязок з активністю користувачів
           night:
             label: Нічна закономірність

data/config/locales/zh-CN.yml

@@ -38,6 +38,7 @@ zh-CN:
         critical: "\U0001F534 严重"
         not_rated: "未评级"
         not_rated_hint: "评级是在平台之间比较的，因此至少需要两个平台上的错误。"
+        nothing_resolved: "此期间的错误均尚未解决"
       device_type:
         mobile: Mobile
         tablet: Tablet
@@ -323,7 +324,7 @@ zh-CN:
         types:
           business_hours:
             label: 工作时段规律
-            description: 错误高峰出现在工作时段（9:00–17:00），说明与用户活动相关
+            description: 错误高峰出现在工作时段（9:00–17:59），说明与用户活动相关
           night:
             label: 夜间规律
             description: 错误高峰出现在夜间（0:00–6:00），可能来自后台任务或定时作业

data/lib/rails_error_dashboard/configuration.rb

@@ -735,6 +735,13 @@ module RailsErrorDashboard
                     "Feature has been auto-disabled. Upgrade Ruby to use this feature."
         @detect_swallowed_exceptions = false
       end
+
+      # Rails 7.0.0-7.0.8.7 render request exceptions without reporting them, so
+      # RED never sees them. Rails 7.0.10 backported 7.1's reporting.
+      if defined?(ActionPack) && ActionPack.gem_version < Gem::Version.new("7.0.10")
+        warnings << "Rails #{ActionPack.gem_version} does not report the request exceptions it renders as error pages, " \
+                    "so unhandled request errors are not recorded. Upgrading to Rails 7.0.10 or later fixes this."
+      end
       # Validate sub-settings only if feature is still active after version check
       if detect_swallowed_exceptions
         if swallowed_exception_max_cache_size && swallowed_exception_max_cache_size < 1

data/lib/rails_error_dashboard/queries/platform_comparison.rb

@@ -65,6 +65,13 @@ module RailsErrorDashboard
         @volume ||= Queries::EventVolume.new(base_scope, @start_date)
       end
 
+      # Events per platform for the platforms with errors in the window, the
+      # only ones scored or given a health card. Errors with no platform value
+      # belong to none.
+      def active_error_rates
+        @active_error_rates ||= error_rate_by_platform.except(nil)
+      end
+
       # platform => { error_type => events in the window }.
       #
       # Severity, critical counts and cross-platform totals all fold from this
@@ -158,32 +165,50 @@ module RailsErrorDashboard
       # Higher score = more stable (fewer errors, faster resolution)
       # @return [Hash] Platform => stability score
       def platform_stability_scores
-        platforms = base_scope.distinct.pluck(:platform).compact
-        error_rates = error_rate_by_platform
+        # Only platforms with errors in the window are scored. Every platform
+        # ever seen used to be, and one with none in the window scored 100.
+        error_rates = active_error_rates
         # A score compares platforms. With fewer than two that have errors in
         # the window there is nothing to compare against, so none is rated (a
-        # lone platform used to come out Critical every time). The count is of
-        # platforms with errors in the window: the list above is every
-        # platform ever seen.
+        # lone platform used to come out Critical every time).
         return {} if error_rates.size < 2
         resolution_times = resolution_time_by_platform
 
         total_errors = error_rates.values.sum
-        max_resolution_time = resolution_times.values.compact.max || 1
+        even_share = 1.0 / error_rates.size
+        fastest_resolution = resolution_times.values_at(*error_rates.keys).compact.min
+
+        error_rates.each_with_object({}) do |(platform, error_count), result|
+          avg_resolution = resolution_times[platform]
+
+          # This platform's share of all errors against an even split: full
+          # credit at or below it, falling linearly to 0 when one platform has
+          # every error. Against the raw share instead, no evenly split app
+          # could be Healthy. The even-split test is done in integers so an
+          # exact split is never lost to rounding.
+          error_score = if error_count * error_rates.size <= total_errors
+            1.0
+          else
+            1.0 - (((error_count.to_f / total_errors) - even_share) / (1.0 - even_share))
+          end
 
-        platforms.each_with_object({}) do |platform, result|
-          error_count = error_rates[platform] || 0
-          avg_resolution = resolution_times[platform] || 0
-
-          # This platform's share of all errors, inverted. Against the busiest
-          # platform instead, the busiest always scored 0 here and so was always
-          # Critical.
-          error_score = total_errors.positive? ? 1.0 - (error_count.to_f / total_errors) : 1.0
-          resolution_score = avg_resolution.positive? ? 1.0 - (avg_resolution / max_resolution_time) : 1.0
-
-          # Weight: 70% error count, 30% resolution time
-          # Convert to 0-100 scale
-          result[platform] = ((error_score * 0.7 + resolution_score * 0.3) * 100).round(1)
+          # The fastest platform's average resolution time over this one's,
+          # each floored at one hour: the fastest and any as fast get full
+          # credit, one twice as slow gets half. Against the slowest instead,
+          # the slowest always scored 0 here. The floor keeps an average of 0.0
+          # (resolved at once) from leaving every other platform with none.
+          result[platform] = if avg_resolution
+            resolution_score = [ fastest_resolution, 1.0 ].max / [ avg_resolution, 1.0 ].max
+
+            # Weight: 70% error count, 30% resolution time
+            # Convert to 0-100 scale
+            ((error_score * 0.7 + resolution_score * 0.3) * 100).round(1)
+          else
+            # Nothing resolved in the window: no resolution time to compare, so
+            # the score is the volume credit alone, on the same scale. It used
+            # to get the full resolution credit. The cards say which it is.
+            (error_score * 100).round(1)
+          end
         end
       end
 
@@ -227,12 +252,13 @@ module RailsErrorDashboard
       # Get platform health summary
       # @return [Hash] Platform => health metrics
       def platform_health_summary
-        error_rates = error_rate_by_platform
+        error_rates = active_error_rates
         stability_scores = platform_stability_scores
         severities = severity_distribution_by_platform
         midpoint = @start_date + (@days / 2.0).days
 
-        platforms.each_with_object({}) do |platform, result|
+        # A card for each platform with errors in the window, as the scores
+        error_rates.each_key.with_object({}) do |platform, result|
           platform_scope = base_scope.where(platform: platform)
           groups_in_window = platform_scope.where("occurred_at >= ?", @start_date)
 
@@ -259,6 +285,9 @@ module RailsErrorDashboard
             critical_errors: critical_errors,
             unresolved_errors: unresolved_errors,
             resolution_rate: resolution_rate,
+            # false when nothing from the window is resolved, so the stability
+            # score is volume alone
+            resolution_measured: resolved_errors.positive?,
             # nil and :not_rated when there are fewer than two platforms
             stability_score: stability_scores[platform],
             error_velocity: velocity, # Positive = increasing, negative = decreasing

data/lib/rails_error_dashboard/version.rb

@@ -1,3 +1,3 @@
 module RailsErrorDashboard
-  VERSION = "0.16.0"
+  VERSION = "0.16.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.16.1
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -628,7 +628,7 @@ metadata:
   funding_uri: https://github.com/sponsors/AnjanJ
 post_install_message: |
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-    RED (Rails Error Dashboard) v0.16.0
+    RED (Rails Error Dashboard) v0.16.1
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   First install: