# Running Homepage Application Dashboard on Windows

## What is Homepage?

> [Homepage is] a modern, fully static, fast, secure fully proxied, highly customizable application dashboard with integrations for over 100 services and translations into multiple languages. Easily configured via YAML files or through docker label discovery. -https://github.com/benphelps/homepage

## Installing Homepage

1. Log into the Windows device
2. Download the latest Homepage release Download
3. Download NodeJS Download
4. Install NodeJS > During the install, make sure to check the Tools for Native Modules option
5. At the Native Modules prompt, press any key to begin the installation process
   NOTE: This process takes quite a while to install, be patient. Proceed once the PowerShell window closes
6. Extract the downloaded Homepage files
7. Rename the extracted folder homepage
8. Cut the homepage folder to a location it can safely run from, C:\Program Files\homepage in this example
9. Hold the SHIFT key and right click in the white space > Open PowerShell window here...
10. Run the following commands in the PowerShell window
    # install dependencies
    npm install
    # create .env file from example
    Copy-Item ".\src\skeleton" -Destination ".\config" -Recurse
    # build homepage
    npm run build
    # run homepage
    npm start
11. Open a web browser and navigate to http://DNSorIP:3000
12. Welcome to Homepage

## Run Homepage on System Startup (Optional, but recommended)

1. Press CTRL + C to kill the running Homepage process
2. Open a text editor and paste the following

   :: Start homepage server
   cd /D "%~dp0"
   start "homepage" /b npm start

3. Save the file as homepage.bat in the homepage directory, C:\Program Files\homepage in this example
4. Click on the Start Button > Type task > Launch Task Scheduler
5. Right click the Task Scheduler Library folder in the left pane > Create Basic Task...
6. Set the name to Homepage and optionally set a Description > Click Next
7. For the Trigger, select When the computer starts > Click Next
8. For the Action, select Start a program > Click Next
9. Complete the form fields as follows:

   Program/script: "%ProgramFiles%\homepage\homepage.bat"
   Add arguments:
   Start in:

10. Click Next
11. Check the Open the Properties dialog checkbox > Click Finish
12. In the Properties dialog, click the Change User or Group... button
13. Type System in the Object name field > Click OK
14. Check the Run with highest privileges box
15. Click OK to create the scheduled task
16. Right click the Homepage task > Run
17. Refresh the open web browser to verify Homepage is now running from the scheduled task

Source: https://github.com/gethomepage/homepage?tab=readme-ov-file#with-node