Need help?

Find your question below or ask one of our communities

My computer warns me when I try to install Ferdium

Even though Ferdium code is signed through the appropriate certificates, some warnings may still appear.

On MacOS:

Any app that has been downloaded from internet will give you a warning asking you to confirm its opening. You can read on that popup that the app has been checked for malware by Apple which did not find any. This means that the software has been submitted to Apple as part of the build process to be notarized. You can thus safely ignore this warning and open the app.

On Windows:

You might see the Windows SmartScreen appear, telling you that "Windows protected your PC" by preventing an unrecognised app from starting. You have the option to click on "More Info" which will display the app name as well as the publisher name. Verify that the app is indeed "Ferdium" and that Publisher corresponds to "Ambroise Grau" (more details below). You can then safely click on "Run anyway" and use the app. If you inadvertently clicked on "Don't run", you won't be presented with SmartScreen another time. You can however right-click on the executable to go into the file's properties and tick the "Unblock" box at the bottom of the window, which will allow its execution by double-click once again.

Why do I see the name "Ambroise Grau" as publisher instead of "Ferdium"?

Since Ferdium is not recognised as a legal entity, it is not possible to obtain certificates under the organisation's name. For this reason, the certificates to sign releases for both MacOS and Windows have been taken under the personal name of one of the project maintainers, namely "Ambroise Grau". This is the name that should appear when verifying the certificate or the publisher name of the software.

Which asset should I download?

All the assets are named under the following convention: `Ferdium-<target_os>[-<os_option>]-<version_with_channel>[-<target_arch>].<extension>`. More precisely for the different OS, you should choose the file appropriately as follows:

For MacOS:

You first need to know if you are using a computer running one of the intel chip or one of the more recent arm chip (developed only by Apple and called M1 or M2). If you do not know it, check the value in `Menu->About this Mac`. If you have an arm chip you need to look for the assets that contain `arm64` in their name. There are then two choices: the first one is to download the appropriate file named `Ferdium-mac-bundle-6.x.x*.zip` which will unzip to give you the application directly; whilst the second choice is to get the file `Ferdium-mac-6.x.x*.dmg` which will mount and allow you to drag the application into your `Applications` folder. Both options are valid (though using the dmg is recommended) as long as you make sure to take the asset corresponding to your processor.

For Windows:

There are 2 types of assets that can be downloaded to get Ferdium on Windows:

The automatic installer (recommended): assets named `Ferdium-win-AutoSetup-6.x.x*.exe`. These executables will install Ferdium and all its configuration into the AppData\Local folder without prompt.
The portable version: corresponds to the asset named `Ferdium-win-Portable-6.x.x*.exe`. This is a standalone application that will create the configuration folder in the folder where the executable lies instead of storing it into AppData.

For both of these, there are assets corresponding to the specific architectures (names ending with `-ia32.exe` for 32bits, `-x64.exe` for 64bits, or `-arm64.exe` for arm) which only contain the given architecture. If you are unsure which one is best for you, you can download the universal version (the asset name which does not include architecture tag between the version and `.exe`). This executable includes everything to run on all architectures, which means it will be heavier, but will always work as expected. If you are running the installer, it will install only for the correct architecture, and you will be able to delete the installer file afterwards.

For Linux:

The `Ferdium-6.x.x-*.AppImage` is a binary that can be executed immediately and that does not necessitate any installation. Alongside this, there are multiple package files for different types of Linux distributions, such as `.freebsd`, `.rpm` and `.deb` (the latter having multiple available architecture). All of these configure their local configuration into the home folder.

For any developer that wants to build from source, the code is also directly available for each release the app can be built simply by running the appropriate scripts found in the `script` folder (assuming that the environment has been set up correctly).

Can I run the beta/nightly version alongside the stable one?

In short, no! This is due to the fact that the executables have the same name and are installed in the same place, which means that when you install a version it will write over the previously installed one, whichever it was previously. This means that you can upgrade, downgrade, change the channel you are on by simply installing the version you want; but you cannot have the stable release and a development release installed at the same time.

Will I lose my configuration by installing a different release?

When you install a release, the configuration folder will not be modified. You can then safely install a nightly/beta version to test them and then install the stable, or the other way around, and all your services and settings will come with you. (Notice that you cannot have multiple releases installed as explained above.)

I can't find the menu bar anymore

Not seeing the menu bar (File, Edit, View, Etc.) might mean that it is hidden, and it can be found by pressing "Alt".
If you want to prevent it from auto-hiding again, un-tick the option:
"View > auto-hide menu bar"

I can't find the service I'm looking for

The "Custom Website" service allows you to add your own website and with the icon of your choosing!

If you want to help the and add your service to the official Ferdium services, you can do so by contributing to Ferdium Recipes.

I want to sync my services and workspaces but I don't want a Ferdium account

You can host your own server with Ferdium Server, which allows you to create your own account. If you chose the accountless option when signing up in Ferdium for the first time, you can follow these steps to create backups manually.

I want to switch from a Franz/Ferdi/Ferdium account to the accountless option

This is a great idea since it looks like you don't want your data to be stored on someone else's cloud. It also means that you can be shielded from any outages (both voluntary and involuntary) of the server in question. All you will need to do is to take a backup of your settings from your current server (answered in the above faq), and then logout in Ferdium, and choose the appropriate button in the login page. Once you get into the accountless option, you can follow the similar instructions as above to import your configurations, services and workspaces.

Where can I report a bug?

First, see if your problem has already been reported by searching for it in our Issue Tracker.
If you can't find it, report it below!

Ferdium Client	Ferdium Server
Issue Tracker	Issue Tracker
Report	Report

Can I move my data from Ferdi to Ferdium?

Yes you can! Follow this guide.

Where can I find the Ferdium profile folder on my local machine?

Windows: %APPDATA%/Ferdium Mac: ~/Library/Application\ Support/Ferdium Linux: ~/.config/Ferdium/

My Discord service is not showing properly. What should I do?

This is because of the User Agent within the service. Discord thinks you are on a mobile site instead of a desktop site.
It can be solved by right-clicking on the discord service that you are using from the sidebar and choosing `Edit`. Scroll down and update the `User Agent`. A full list of User Agents can be found here.

Can multiple services use the same profile such that login information is shared amongst them?

No, this is not planned in Ferdium since that can open the pandora's box related to session hijacking.