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