Files
ncd-fe/docs/installing/pleroma-akkoma.md
nicole mikołajczyk ef86dcd2b7 docs: update
Signed-off-by: nicole mikołajczyk <git@mkljczk.pl>
2026-03-22 19:19:12 +01:00

1.8 KiB

title, section, order
title section order
Pleroma/Akkoma Installing 32

Installing Nicolium as Pleroma/Akkoma frontend

Installation in instance static directory

The most straightforward way to install Nicolium as a frontend for Pleroma or Akkoma is to simply download it and place its files in the /instance/static directory of your Pleroma/Akkoma installation (usually /opt/pleroma/instance/static or /opt/akkoma/instance/static, accordingly).

curl -O https://web.nicolium.app/release.zip
unzip release.zip -d /opt/pleroma/instance/static/
rm release.zip

Installation via Pleroma/Akkoma frontend management

It is also possible to use the Pleroma/Akkoma frontend management tool. You can find more information about it in the Pleroma documentation. You can use either the PleromaFE built-in admin dashboard or the older AdminFE to install Nicolium and set it as the server frontend. You don't have to provide any URL. It's right there in Pleroma/Akkoma (under the name pl-fe).

To install it from CLI, use:

OTP

./bin/pleroma_ctl frontend install nicolium --ref release --build-url https://web.nicolium.app/release.zip --build-dir .

From Source

mix pleroma.frontend install nicolium --ref release --build-url https://web.nicolium.app/release.zip --build-dir .

It is now possible to set Nicolium as the primary frontend in the configuration file or via AdminFE:

config :pleroma, :frontends,
  primary: %{
    "name" => "nicolium", # Use `pl-fe` if you installed it via Pleroma/Akkoma dashboard
    "ref" => "release"
  },
  ...

On Akkoma, it is also possible for individual users to select their preferred frontend to Nicolium by visiting /akkoma/frontend page on their Akkoma instance.