Docs

Installation via installer (Windows Server)

Ferron can be installed on Windows Server using an installer script. This guide will walk you through the installation process.

Installation steps⁠#

1. Run the installer⁠#

To install Ferron web server, run the following command:

powershell -c "irm https://get.ferron.sh/v2-win | iex"

You will be prompted to choose the installation type.

2. Access the web server⁠#

By default, Ferron serves content from the %SystemDrive%\ferron\wwwroot directory. Open a web browser and navigate to http://localhost to check if the server is running and serving the default index.html file.

If you see a “Ferron is installed successfully!” message on the page, the web server is installed successfully and is up and running.

File structure⁠#

Ferron installed via the installer for Windows Server has following file structure:

  • %SystemDrive%\ferron\ferron.exe - Ferron web server
  • %SystemDrive%\ferron\ferron-passwd.exe - Ferron user password generation tool
  • %SystemDrive%\ferron\ferron-precompress.exe - Ferron static files precompression tool
  • %SystemDrive%\ferron\ferron-yaml2kdl.exe - Ferron configuration conversion tool
  • %SystemDrive%\ferron\log\access.log - Ferron access log in Combined Log Format
  • %SystemDrive%\ferron\log\error.log - Ferron error log
  • %SystemDrive%\ferron\wwwroot - Ferron’s web root
  • %SystemDrive%\ferron\ferron.kdl - Ferron configuration

Managing the Ferron service⁠#

Stopping the service⁠#

To stop the Ferron service, run:

net stop ferron

Restarting the service⁠#

To restart the service:

net stop ferron
net start ferron