Icons missing after update to v2025.3.9.0

Valentinus

I've updated on a normal hosting with npm and nginx from v2025.3.1 to v2025.6.0. Everything went well. After updating to v2025.3.9.0 I encountered missing icons on the index site and in the drive overview page. The developer console of the browser is showing some error messages about missing icons. You can investigate at https://cp.uugrn.org/

The checkup page says "55 / 55 tests passed."

Image description

Mathilde

Hello,

2025.3.9.0 doesn't exist, shall we assume you mean 2025.9.0?

Did you follow the upgrade notes? Especially the following step?

npm run install:components

Do let us know!

Valentinus

Mathilde
Yes I followed the update instructions in the release notes on github.
In fact, I've done the following:

git fetch --depth 1 origin tag 2025.9.0
git checkout 2025.9.0
npm ci
npm run install:components
./install-onlyoffice.sh
npm run api
npm run build

diff config/config.example.js config/config.js

Mathilde

Thank you for sharing the commands you used.

For your information both run api & build are useless in this case and could even interfere with a proper production setup. We do not recommend running these commands, they aren't listed in our upgrade notes.

Can you please try again upgrading? Sticking with the commands listed in the release note for 2025.9.0 this time?

Valentinus

I'm not sure how to do that. Just do the commands again or install a backup and do the process once more?

So only these?

git fetch --depth 1 origin tag 2025.9.0
git checkout 2025.9.0
npm ci
npm run install:components
./install-onlyoffice.sh

Mathilde

If you have a working backup that is easy to restore, I believe it would be better indeed.

Valentinus So only these?

Yes, just follow the upgrade notes.

You don't even need to run the OnlyOffice install script again as we didn't updated it for this release.

Valentinus

I've resetted to a backup before the upgrade and followed the upgrade notes.

Result: The same as before. The bug is still there.

In the release notes of the Autumn release (2025.9.0) there is mentioned that font awesome was removed. Could this cause the problem?

Does "Restart your server" means "Reboot your server" or "Restart your cryptpad"?

I've again installed a backup and updated to v2025.6.0

Mathilde

Hello,

Valentinus Does "Restart your server" means "Reboot your server" or "Restart your cryptpad"?

This means restarting your CryptPad instance. Following the administrator guide, this is done by using the systemctl System and Service Manager command:

sudo systemctl restart cryptpad.service

Are you running customizations on your instance? Did you modify the content of the customize.dist/ folder? Did you create customize/?

Valentinus

Mathilde
There is a folder customize.dist/
and a folder customize/
No known customization. The only changed file is the one where the settings live in.

There is an application_config.js in the customize folder:

[...]
  // Customize the icon used for each application.
    // You can update the colors by making a copy of /customize.dist/src/less2/i
nclude/colortheme.less
    AppConfig.applicationsIcon = {
        file: 'cptools-file',
        fileupload: 'cptools-file-upload',
        folderupload: 'cptools-folder-upload',
        link: 'fa-link',
        pad: 'cptools-richtext',
        code: 'cptools-code',
        slide: 'cptools-slide',
       poll: 'cptools-poll',
        form: 'cptools-poll',
        whiteboard: 'cptools-whiteboard',
        diagram: 'cptools-diagram',
        todo: 'cptools-todo',
        contacts: 'fa-address-book',
        calendar: 'fa-calendar',
        kanban: 'cptools-kanban',
        doc: 'fa-file-word-o',
        presentation: 'fa-file-powerpoint-o',
        sheet: 'fa-file-excel-o',
        drive: 'fa-hdd-o',
        teams: 'fa-users',
        admin: 'fa-gears',
        settings: 'fa-gear',
        moderation: 'fa-ambulance',
        profile: 'fa-user-circle',
        support: 'fa-life-ring',
        accounts: 'fa-ticket'
    };
[...]
``

Mathilde

Hello @Valentinus,

Valentinus and a folder customize/

This is indeed the cause of the issue you are facing. If you didn't do any modification, there shouldn't be such folder. It must have been created when you wrongfully ran the npm run build command.

Please delete it, then upgrade again following the upgrade instructions. There won't be an issue where the icon files names are overwritten by customize/application_config.js.

Valentinus

Mathilde Thank you for your help.

It would be great to enhance the documentation or mention it in the release note upgrade guide that something has changed in the /www/common/application_config_internal.js "Please review your customize/application_config.js, if you make use of it".

You can Change the title to [solved] Icons missing after update to v2025.3.9.0