You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/releases.md
+39-4Lines changed: 39 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,9 +34,48 @@
34
34
35
35
Released on Dec 31st, 2025
36
36
37
+
#### IMPORTANT NOTICE: BREAKING CHANGES AHEAD
38
+
39
+
First and foremost, Version 7 is NOT compatible with php 8.3. The minimum required version is now php 8.4.
40
+
If you are using the release build (with nginx/apache + PHP), please make sure to update your environment accordingly.
41
+
42
+
Version 7 docker image is now powered by FrankenPHP with Laravel Octane instead of the traditional nginx + PHP-FPM stack. **Upgrading will require you to update your docker-compose setup.**
43
+
44
+
Check the upgrade documentation for more information: [https://lycheeorg.dev/docs/upgrade.html](https://lycheeorg.dev/docs/upgrade.html)
45
+
37
46
#### Major release: Webshop, star ratings, and more!
38
47
48
+
Read more on our [blog post](https://lycheeorg.dev/2025-12-31-version-7/) about Version 7.
49
+
50
+
#### Most notable changes
51
+
52
+
`SE` refers to functionalities that are aimed at the Supporter/Pro Edition.
53
+
`klo` refers to *Keep the Light On*. In other words, basic software updates.
54
+
39
55
56
+
*`klo`#3880 : Spec driven development support by @ildyria.
57
+
*`new`#3881 : Add support for hprof in order to have profiling by @ildyria.
58
+
> This will help us to profile and optimize Lychee for speed and memory useage..
59
+
*`new`#3879 : Add option to make the smart albums only consider photos of the user by @ildyria.
60
+
*`SE`#3868 : Webshop by @ildyria.
61
+
> The biggest feature addition of 2025! After 6 months of intensive development, we're proud to introduce our fully-integrated webshop solution.
62
+
*`new`#3889 : Switching to Octane with Frankenphp by @ildyria.
63
+
> Major architectural change: Our Docker release is now powered by FrankenPHP with Laravel Octane instead of the traditional nginx + PHP-FPM stack.
64
+
*`fix`#3892 : Fix tag-pinned-shared albums not being reset by @ildyria.
65
+
*`new`#3893 : Add avif support by @ildyria.
66
+
> Add native avif support using the imagick extension.
67
+
*`new`#3896 : Support titles as dates for albums by @ildyria.
68
+
> If your album is titled with a date format, we will now integrate it in the timeline display.
69
+
*`new`#3898 : PHP 8.3 is dead by @ildyria.
70
+
> As each year, we drop support for the oldest php version. This year, php8.3 is no longer supported.
71
+
*`SE`#3899 : Add rating per user by @ildyria.
72
+
> We add ratings per user. Each user can now rate photos from 1 to 5 stars.
73
+
> Supporters have access to slightly more configurations options.
74
+
*`new`#3903 : feat: add worker mode support for horizontal scaling by @ildyria.
75
+
> This allows to run Lychee in a horizontally scaled environment with multiple workers.
76
+
> In other words you can now process images in the background with multiple workers.
77
+
*`new`#3905 : Add pre-computation of thumb images for improved speed by @ildyria.
78
+
> We now pre-compute the thumb album cover and min-max dates for albums to improve speed when loading albums.
40
79
41
80
42
81
## Version 6
@@ -154,10 +193,6 @@ This means that you will need to update your verification process accordingly. P
154
193
155
194
#### Most notable changes
156
195
157
-
`SE` refers to functionalities that are aimed at the Supporter Edition.
158
-
`klo` refers to *Keep the Light On*. In other words, basic software updates.
159
-
160
-
161
196
*`fix`#3700 : Fix user group issues by @ildyria.
162
197
*`klo`#3701 : Split test suite in hopes to speed things up. by @ildyria.
163
198
> We split the test suite in multiple jobs to speed up the overall test execution time.
Copy file name to clipboardExpand all lines: src/content/post/2025-12-31-version-7.mdx
+16-5Lines changed: 16 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,19 +25,22 @@ Security remained a priority with multiple SSRF vulnerability fixes, ensuring yo
25
25
26
26
Version 7 marks a major architectural shift for Lychee. Our Docker release is now powered by FrankenPHP with Laravel Octane instead of the traditional nginx + PHP-FPM stack. This infrastructure keeps the framework in memory and reuses components across requests, eliminating the overhead of rebuilding the entire application on every page load. As a result, boot time drops from 40-60ms to just 4-6ms per request, with 3-4x better throughput and significantly reduced latency. In May 2025, FrankenPHP gained official support from the PHP Foundation, cementing its position as the future of high-performance PHP applications.
27
27
28
-
The new FrankenPHP-powered Docker image is available at `ghcr.io/lycheeorg/lychee` and will become the default once version 7 is fully stable.
28
+
The new FrankenPHP-powered Docker image is available at `ghcr.io/lycheeorg/lychee` and has become the default now that Version 7 is fully stable.
29
29
30
-
This architectural change means you will need to update your Docker setup when upgrading from version 6 to version 7 with FrankenPHP. Please refer to our [upgrade documentation](https://lycheeorg.github.io/docs/upgrade.html) for detailed instructions.
30
+
This architectural change means you will need to update your Docker setup when upgrading from Version 6 to Version 7 with FrankenPHP. Please refer to our [upgrade documentation](https://lycheeorg.github.io/docs/upgrade.html) for detailed instructions.
31
31
32
-
Do note that this change also has consequences in the way Lychee reads your `.env`
32
+
**IMPORTANT: PHP 8.4 Required** - Version 7 requires PHP 8.4 or higher. If you are using the release build with nginx/apache + PHP (not Docker), ensure your environment is updated accordingly before upgrading.
33
+
34
+
Do note that the FrankenPHP change also has consequences in the way Lychee reads your `.env`
33
35
file. Updating values in the `.env` file will now require a container restart to take effect.
34
36
35
37
#### Performance Revolution
36
38
37
39
In addition to changing the PHP engine, we've implemented several key performance optimizations:
38
40
39
41
-**Asymmetric Processing**: Intelligent parallel processing for photo imports, slashing the time needed to upload and process large photo collections
40
-
-**Album Loading Optimization**: Deep refactoring of our codebase to handle large albums with grace, ensuring smooth browsing even with thousands of photos
42
+
-**Worker Mode for Horizontal Scaling**: Ability to run Lychee with multiple workers for background image processing, enabling truly scalable deployments
43
+
-**Album Pre-computation**: Smart caching of album covers and date ranges, dramatically improving album loading times
41
44
42
45
#### New Features That Matter
43
46
@@ -51,7 +54,15 @@ In addition to changing the PHP engine, we've implemented several key performanc
51
54
52
55
The Webshop empowers photographers to monetize their work without leaving their Lychee galleries, opening new revenue streams and simplifying the sales process. This feature is exclusive to Lychee Pro users.
53
56
54
-
As a thank you to our loyal supporters, we've granted Lychee Pro access to all existing supporters at the $10/month tier or higher. This is our way of recognizing the community that makes Lychee possible.
57
+
As a thank you to our loyal supporters, we've granted Lychee Pro access to all our existing supporters. It is now available at the $10/month tier or with any one-time support contribution. This is our way of recognizing the community that makes Lychee possible.
58
+
59
+
**New License Key Delivery System**: We've streamlined the license activation process with a self-service solution! Instead of receiving keys by email, our new automated system at [keygen.lycheeorg.dev](https://keygen.lycheeorg.dev) automatically checks your supporter tier and instantly provides you with the appropriate license key for your level. Get your Lychee Pro key on-demand, whenever you need it.
60
+
61
+
**Additional Features**:
62
+
-**AVIF Support**: Native support for the AVIF image format using the imagick extension, bringing next-generation image compression to your galleries
63
+
-**Timeline Enhancements**: Album titles formatted as dates now automatically integrate into the timeline display for better organization
64
+
-**Smart Album Improvements**: New option to make smart albums only consider photos belonging to the specific user
65
+
-**Profiling Support**: Added hprof support to enable detailed performance profiling and optimization
Copy file name to clipboardExpand all lines: src/pages/roadmap.astro
+12-12Lines changed: 12 additions & 12 deletions
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ const metadata = {
8
8
9
9
// Release data extracted from releases.md
10
10
const releases = [
11
-
{ version: 'v7.0.0', date: 'Soon...', title: 'Upcoming Major Release', type: 'major', highlights: ['Stay tuned for exciting new features and improvements!'] },
{ version: 'v6.10.3', date: 'Dec 4, 2025', title: 'Video support in embedded galleries', type: 'feature', highlights: ['Added video support to embedded galleries', 'Translations in EmbedCodeDialog', 'Fixed base URL for embedded galleries'] },
14
14
{ version: 'v6.10.2', date: 'Nov 18, 2025', title: 'Translation updates and fixes', type: 'enhancement', highlights: ['Translation of all settings in admin panel', 'Fixed groups not loading in share dialog', 'Fixed SmartAlbum portrait errors'] },
0 commit comments