Skip to content

feat(stacks): rework pages + new Jekyll tag #3812

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Frzk wants to merge 8 commits into
base: master
Choose a base branch
from
Draft

feat(stacks): rework pages + new Jekyll tag #3812

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
3e51626
feat(stacks): update stacks overview
Frzk Jun 5, 2026
7a2d90f
feat(stacks): introduce new Jekyll tag for stacks
Frzk Jun 5, 2026
cc9bb66
chore(stacks): rename stacks page
Frzk Jun 5, 2026
11e9b1b
fix: update links to stacks page
Frzk Jun 9, 2026
0a8231f
feat(stack tag): introduce new Jekyll stack tag
Frzk Jun 22, 2026
aff73ee
fix(stacks): update FIXMEs
Frzk Jun 22, 2026
cd5ead2
chore(stacks): fix erroneous links
Frzk Jun 22, 2026
f4c0693
chore(stacks): fix missing link
Frzk Jun 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 39 additions & 2 deletions assets/style.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -495,9 +495,12 @@ article aside.note a {
font-weight: var(--font-weight-bold, 700);
}

article aside.note code.language-plaintext {
article aside.note code.language-plaintext,
article .stack:not(table .stack) {
background-color: var(--color-primary-purple-200-60);
color: var(--color-primary-purple-800);
padding: 0 0.33rem;
border-radius: 6px;
}

article aside.warning {
Expand Down Expand Up @@ -765,7 +768,8 @@ article pre {
}
}

article code.language-plaintext {
article code.language-plaintext,
article .stack:not(table .stack) {
background-color: var(--color-sc-gray-3);
color: var(--color-sc-gray-2);
font-family: var(--font-mono);
Expand Down Expand Up @@ -1206,3 +1210,36 @@ ol.deploy-timeline {
}
}
}

article .stack {
align-items: center;
display: inline-flex;
gap: 0.33rem;

&::after {
content: "\25CF"; /* ⏺ (black circle) */
}

&.default,
&.supported {
&::after {
color: rgb(103, 194, 58);
margin-top: -0.1rem; /* Small adj. for v-alignment */
}
}

&.deprecated {
&::after {
color: rgb(230, 162, 60);
content: "\25B2"; /* ▲ (plain up-pointing triangle) */
margin-top: -0.2rem; /* Small adj. for v-alignment */
}
}

&.discontinued {
&::after {
color: rgb(245, 108, 108);
content: "\1F7AD"; /* 🞭 (very heavy saltire) */
}
}
}
2 changes: 1 addition & 1 deletion src/_includes/nginx_versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ Scalingo supports the following versions of Nginx:

{% include scalingo_22_deprecation_note.md %}

[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
11 changes: 9 additions & 2 deletions src/_includes/scalingo_22_deprecation_note.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,11 @@
{% note %}
The [`scalingo-22`]({% post_url platform/internals/stacks/2000-01-01-scalingo-22-stack %}) stack is deprecated and will be discontinued on June 1, 2027.
Applications must be migrated to [`scalingo-24`]({% post_url platform/internals/stacks/2000-01-01-scalingo-24-stack %}) or [`scalingo-26`]({% post_url platform/internals/stacks/2000-01-01-scalingo-26-stack %}) before this date.
[{% scalingo 22 %}][scalingo-22] is now deprecated.\\
It will be discontinued on June 1, 2027. Applications must be migrated to
another [stack], such as [{% scalingo 24 %}][scalingo-24] or
[{% scalingo 26 %}][scalingo-26] before this date.
{% endnote %}

[stack]: {% post_url platform/internals/stacks/2000-01-01-overview %}
[scalingo-22]: {% post_url platform/internals/stacks/2000-01-01-scalingo-22-stack %}
[scalingo-24]: {% post_url platform/internals/stacks/2000-01-01-scalingo-24-stack %}
[scalingo-26]: {% post_url platform/internals/stacks/2000-01-01-scalingo-26-stack %}
25 changes: 25 additions & 0 deletions src/_plugins/jekyll-stack-tag.rb
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
module Jekyll
class StackTag < Liquid::Tag
CLASSES = {
"26" => "supported",
"24" => "supported",
"22" => "deprecated",
"20" => "discontinued",
"18" => "discontinued",
"14" => "discontinued"
}.freeze

def initialize(tag_name, markup, tokens)
super
@stack = markup.strip
end

def render(context)
css_class = CLASSES.fetch(@stack, "unknown")

%(<span class="stack #{css_class}" title="Current status: #{css_class.capitalize}">scalingo-#{@stack}</span>)
end
end
end

Liquid::Template.register_tag("scalingo", Jekyll::StackTag)
2 changes: 1 addition & 1 deletion src/_posts/addons/scalingo-openvpn/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ It depends on the stack:
* `scalingo-24`: [2.6.x](https://packages.ubuntu.com/noble/amd64/openvpn)
* `scalingo-26`: [2.7.x](https://packages.ubuntu.com/resolute/amd64/openvpn)

_[More information about stacks]({% post_url platform/internals/stacks/2000-01-01-stacks %})_
_[More information about stacks]({% post_url platform/internals/stacks/2000-01-01-overview %})_

### I would like to configure the DNS with the `dhcp-option` configuration, is it possible?

Expand Down
16 changes: 8 additions & 8 deletions src/_posts/languages/go/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Go
nav: Introduction
modified_at: 2026-06-16 00:00:00
modified_at: 2026-06-22 00:00:00
tags: go
index: 1
---
Expand All @@ -14,11 +14,11 @@ The Go programming language is supported.

The following versions of Go are available:

| Go Version | `scalingo-22` ([EOL]) | `scalingo-24` | `scalingo-26` |
| ----------: | --------------------: | --------------: | --------------: |
| **`1.26`** | up to `1.26.4` | up to `1.26.4` | up to `1.26.4` |
| **`1.25`** | up to `1.25.11` | up to `1.25.11` | up to `1.25.11` |
| **`1.24`** | up to `1.24.13` | up to `1.24.13` | up to `1.24.13` |
| Go Version | {% scalingo 22 %} | {% scalingo 24 %} | {% scalingo 26 %} |
| ---------: | ----------------: | ----------------: | ----------------: |
| **`1.26`** | up to `1.26.4` | up to `1.26.4` | up to `1.26.4` |
| **`1.25`** | up to `1.25.11` | up to `1.25.11` | up to `1.25.11` |
| **`1.24`** | up to `1.24.13` | up to `1.24.13` | up to `1.24.13` |

The default Go version on all stacks is the latest `go1.25` version.

Expand Down Expand Up @@ -88,5 +88,5 @@ limit for the full process memory. For more details, refer to the

More information at [https://github.com/Scalingo/go-buildpack](https://github.com/Scalingo/go-buildpack).

[go-runtime-env]: https://pkg.go.dev/runtime#hdr-Environment_Variables
[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life

[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
20 changes: 10 additions & 10 deletions src/_posts/languages/java/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Java on Scalingo
nav: Introduction
modified_at: 2026-05-26 00:00:00
modified_at: 2026-06-22 00:00:00
tags: java
index: 1
---
Expand All @@ -14,14 +14,14 @@ Java is officially supported on Scalingo

The following Java versions are available:

| Java SE Version | `scalingo-22` ([EOL]) | `scalingo-24` | `scalingo-26` |
| --------------: | --------------------: | ----------------: | ----------------: |
| **`26`** | up to `26.0.1` | up to `26.0.1` | up to `26.0.1` |
| **`25 (LTS)`** | up to `25.0.3` | up to `25.0.3` | up to `25.0.3` |
| **`21 (LTS)`** | up to `21.0.11` | up to `21.0.11` | up to `21.0.11` |
| **`17 (LTS)`** | up to `17.0.19` | up to `17.0.19` | up to `17.0.19` |
| **`11 (LTS)`** | up to `11.0.31` | up to `11.0.31` | up to `11.0.31` |
| **`8 (LTS)`** | up to `1.8.0_492` | up to `1.8.0_492` | up to `1.8.0_492` |
| Java SE Version | {% scalingo 22 %} | {% scalingo 24 %} | {% scalingo 26 %} |
| --------------: | ----------------: | ----------------: | ----------------: |
| **`26`** | up to `26.0.1` | up to `26.0.1` | up to `26.0.1` |
| **`25 (LTS)`** | up to `25.0.3` | up to `25.0.3` | up to `25.0.3` |
| **`21 (LTS)`** | up to `21.0.11` | up to `21.0.11` | up to `21.0.11` |
| **`17 (LTS)`** | up to `17.0.19` | up to `17.0.19` | up to `17.0.19` |
| **`11 (LTS)`** | up to `11.0.31` | up to `11.0.31` | up to `11.0.31` |
| **`8 (LTS)`** | up to `1.8.0_492` | up to `1.8.0_492` | up to `1.8.0_492` |

For Java SE 8, the JDK version is numbered `1.8`.

Expand Down Expand Up @@ -213,4 +213,4 @@ More information at
[https://github.com/Scalingo/java-buildpack](https://github.com/Scalingo/java-buildpack).

[java-command]: https://docs.oracle.com/en/java/javase/25/docs/specs/man/java.html
[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
14 changes: 7 additions & 7 deletions src/_posts/languages/nodejs/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Node.js
nav: Introduction
modified_at: 2026-06-16 12:00:00
modified_at: 2026-06-22 12:00:00
tags: nodejs
index: 1
---
Expand All @@ -20,11 +20,11 @@ The file `package.json` should be present at the root of the project.

The following Node.js versions are available:

| Node.js version | `scalingo-22` ([EOL]) | `scalingo-24` | `scalingo-26` |
| --------------: | --------------------: | --------------: | --------------: |
| `v26` | up to `26.3.0` | up to `26.3.0` | up to `26.3.0` |
| `v24` (LTS) | up to `24.16.0` | up to `24.16.0` | up to `24.16.0` |
| `v22` (LTS) | up to `22.22.3` | up to `22.22.3` | up to `22.22.3` |
| Node.js version | {% scalingo 22 %} | {% scalingo 24 %} | {% scalingo 26 %} |
| --------------: | ----------------: | ----------------: | ----------------: |
| `v26` | up to `26.3.0` | up to `26.3.0` | up to `26.3.0` |
| `v24` (LTS) | up to `24.16.0` | up to `24.16.0` | up to `24.16.0` |
| `v22` (LTS) | up to `22.22.3` | up to `22.22.3` | up to `22.22.3` |

{% include scalingo_22_deprecation_note.md %}

Expand Down Expand Up @@ -467,4 +467,4 @@ web: node server.js
```

[nodejs-memory-guide]: https://nodejs.org/learn/diagnostics/memory/understanding-and-tuning-memory
[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
2 changes: 1 addition & 1 deletion src/_posts/languages/php/2000-01-01-dependencies.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,4 +115,4 @@ development dependencies installed (e.g. to debug your app).
In addition to the `--[no-]dev` flag, the platform always runs
`composer install` with the `--prefer-dist` and `--optimize-autoloader` flags.

[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
14 changes: 6 additions & 8 deletions src/_posts/languages/php/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,12 @@ parameters like `upload_max_filesize` or `post_max_size`.

The following PHP versions are available:

| PHP Version | `scalingo-22` ([EOL]) | `scalingo-24` | `scalingo-26` |
| ----------: | --------------------: | -------------: | -------------: |
| **`8.5`** | up to `8.5.7` | up to `8.5.7` | up to `8.5.7` |
| **`8.4`** | up to `8.4.22` | up to `8.4.22` | up to `8.4.22` |
| **`8.3`** | up to `8.3.31` | up to `8.3.31` | up to `8.3.31` |
| **`8.2`** | up to `8.2.31` | up to `8.2.31` | up to `8.2.31` |
| PHP Version | {% scalingo 22 %} | {% scalingo 24 %} | {% scalingo 26 %} |
| ----------: | ----------------: | ----------------: | ----------------: |
| **`8.5`** | up to `8.5.7` | up to `8.5.7` | up to `8.5.7` |
| **`8.4`** | up to `8.4.22` | up to `8.4.22` | up to `8.4.22` |
| **`8.3`** | up to `8.3.31` | up to `8.3.31` | up to `8.3.31` |
| **`8.2`** | up to `8.2.31` | up to `8.2.31` | up to `8.2.31` |

{% include scalingo_22_deprecation_note.md %}

Expand Down Expand Up @@ -453,5 +453,3 @@ location / {
try_files $uri $uri/ /index.php?$args;
}
```

[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
16 changes: 8 additions & 8 deletions src/_posts/languages/python/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Python
nav: Introduction
modified_at: 2026-06-10 12:00:00
modified_at: 2026-06-22 12:00:00
tags: python
index: 1
---
Expand All @@ -21,12 +21,12 @@ your app.

The following versions of Python are available:

| Python Version | `scalingo-22` ([EOL]) | `scalingo-24` | `scalingo-26` |
| -------------- | -------------------: | --------------: | --------------: |
| **`3.14`** | up to `3.14.5` | up to `3.14.5` | up to `3.14.5` |
| **`3.13`** | up to `3.13.13` | up to `3.13.13` | up to `3.13.13` |
| **`3.12`** | up to `3.12.13` | up to `3.12.13` | up to `3.12.13` |
| **`3.11`** | up to `3.11.15` | up to `3.11.15` | up to `3.11.15` |
| Python Version | {% scalingo 22 %} | {% scalingo 24 %} | {% scalingo 26 %} |
| -------------- | ---------------: | ----------------: | ----------------: |
| **`3.14`** | up to `3.14.5` | up to `3.14.5` | up to `3.14.5` |
| **`3.13`** | up to `3.13.13` | up to `3.13.13` | up to `3.13.13` |
| **`3.12`** | up to `3.12.13` | up to `3.12.13` | up to `3.12.13` |
| **`3.11`** | up to `3.11.15` | up to `3.11.15` | up to `3.11.15` |

{% include scalingo_22_deprecation_note.md %}

Expand Down Expand Up @@ -131,4 +131,4 @@ For further details about this calculation, please see the [WEB_CONCURRENCY.sh](

To override the automatically defined value, set the `WEB_CONCURRENCY` environment variable to the desired value.

[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
12 changes: 6 additions & 6 deletions src/_posts/languages/ruby/2000-01-01-start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,11 +81,11 @@ $ git push scalingo master

### Availability

| Ruby Version | `scalingo-22` ([EOL]) | `scalingo-24` | `scalingo-26` |
| -----------: | --------------------: | -------------: | -------------: |
| **`4.0`** | up to `4.0.5` | up to `4.0.5` | up to `4.0.5` |
| **`3.4`** | up to `3.4.9` | up to `3.4.9` | up to `3.4.9` |
| **`3.3`** | up to `3.3.11` | up to `3.3.11` | up to `3.3.11` |
| Ruby Version | {% scalingo 22 %} | {% scalingo 24 %} | {% scalingo 26 %} |
| -----------: | ----------------: | ----------------: | ----------------: |
| **`4.0`** | up to `4.0.5` | up to `4.0.5` | up to `4.0.5` |
| **`3.4`** | up to `3.4.9` | up to `3.4.9` | up to `3.4.9` |
| **`3.3`** | up to `3.3.11` | up to `3.3.11` | up to `3.3.11` |

{% include scalingo_22_deprecation_note.md %}

Expand Down Expand Up @@ -176,4 +176,4 @@ environment variable to the desired value.


[web_concurrency_file]: https://github.com/Scalingo/ruby-buildpack/blob/master/lib/language_pack/ruby.rb
[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
2 changes: 1 addition & 1 deletion src/_posts/platform/app/2000-01-01-review-apps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ application is a child application.

Child applications clone some information from the parent app:
* the [container formation]({% post_url platform/app/scaling/2000-01-01-scaling %})
* the [stack]({% post_url platform/internals/stacks/2000-01-01-stacks %})
* the [stack]({% post_url platform/internals/stacks/2000-01-01-overview %})
* the [environment variables]({% post_url platform/app/2000-01-01-environment %})
* the databases and addons: including version and plans (can be overridden in `scalingo.json`), but _excluding_ the content of the databases.
* the collaborators
Expand Down
9 changes: 6 additions & 3 deletions src/_posts/platform/app/2000-01-01-tailscale.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,9 @@ tailscale
:repo:deb [trusted=yes] https://pkgs.tailscale.com/stable/ubuntu [dist] main
```

Replace `[dist]` with the codename of the [stack]({% post_url platform/internals/stacks/2000-01-01-stacks %}) you are using:
* `resolute` for `scalingo-26`
* `noble` for `scalingo-24` (default)
Replace `[dist]` with the codename of the [stack] you are using:
* `resolute` for `scalingo-26` (default)
* `noble` for `scalingo-24`
* `jammy` for `scalingo-22`

## Step 3: Set TAILSCALE_AUTHKEY Environment Variable
Expand Down Expand Up @@ -99,3 +99,6 @@ You can verify the connection by running a [one-off container]({% post_url platf
{% note %}
The `ALL_PROXY` environment variable directs software that respects it (like `curl`) to use the local SOCKS5 proxy provided by Tailscale.
{% endnote %}


[stack]: {% post_url platform/internals/stacks/2000-01-01-overview %}
2 changes: 1 addition & 1 deletion src/_posts/platform/deployment/2000-01-01-deploy-java-jar-war.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -119,4 +119,4 @@ Even though we still support this version, we strongly advise against using the
please consider migrating to a more recent version.
{% endnote %}

[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
4 changes: 2 additions & 2 deletions src/_posts/platform/deployment/buildpacks/2000-01-01-apt.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ installing additional packages using the `apt` package manager.

Details about the default environment can be found on the following page:
[Scalingo Builder - Our base Docker image]({% post_url
platform/internals/stacks/2000-01-01-stacks %})
platform/internals/stacks/2000-01-01-overview %})

## Set up this buildpack for your application

Expand Down Expand Up @@ -67,7 +67,7 @@ http://downloads.sourceforge.net/project/wkhtmltopdf/0.12.1/wkhtmltox-0.12.1_lin

{% warning %}
You have to make sure the chosen packages are compatible with the stack base distribution.
See [our documentation page]({% post_url platform/internals/stacks/2000-01-01-stacks %})
See [our documentation page]({% post_url platform/internals/stacks/2000-01-01-overview %})
to see how to change your stack and see which is the default base distribution.
{% endwarning %}

Expand Down
2 changes: 1 addition & 1 deletion src/_posts/platform/deployment/buildpacks/2000-01-01-jemalloc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,4 +75,4 @@ variable, like so:
scalingo env-set JEMALLOC_VERSION=4.5.0
```

[EOL]: {% post_url platform/internals/stacks/2000-01-01-stacks %}#stack-end-of-life
[EOL]: {% post_url platform/internals/stacks/2000-01-01-overview %}#lifecycle
2 changes: 1 addition & 1 deletion src/_posts/platform/deployment/buildpacks/2000-01-01-locale.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ at installing additional language packs.

Details about the default environment can be found on the following page:
[Scalingo Builder - Our base Docker image]({% post_url
platform/internals/stacks/2000-01-01-stacks %})
platform/internals/stacks/2000-01-01-overview %})

## Set up this buildpack for your application

Expand Down
Loading