Browse the documentation

How to Install a Plugin on Your Nova-Life Server?

⚠️ Before you start

Always create a backup of your server before installing a plugin. A poorly coded or incompatible plugin may damage your configuration files.

Table of Contents

Prepare the Plugin

Once you have your plugin's files (provided by its developer or retrieved from your usual source), place them in a folder on your computer, ready to be uploaded to your server.

⚠️ Warning: only install plugins from a source you trust. Some files may be malicious or unstable.

Stop the Server

Log in to the FreshPerf panel and fully stop your server before adding any file, using the Start/Stop button in the Console tab.

Add the Plugin via the File Manager

In the panel, open the Files tab, then go to:

/home/container/Servers/[Your server ID]/Plugins/

ℹ️ Your server ID is the numeric folder name found under Servers/ (e.g. 444). Each installed plugin has its own subfolder inside Plugins/.

Once inside the Plugins/ folder, upload your plugin's files using the Upload button (create a dedicated subfolder for your plugin if needed), then extract the archive if necessary (right-click → Extract).

Configure the Plugin

Some plugins have their own configuration file (often .json) that needs to be adapted to your server (coordinates, prices, permissions, etc.). Refer to the documentation provided with the plugin.

Restart the Server

Once the plugin is in place, restart your server from the panel's Console tab.

Verify the Installation

Check the server console on startup: most plugins display a confirmation message (e.g. [Plugin] Loaded successfully). If there's an error, check that all files were extracted to the correct location and that the plugin is compatible with your Nova-Life version.

🇬🇧 Reminder: always install plugins with the server stopped, and keep a recent backup in case something goes wrong.