0ct0pu5
/
tutorials


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102
							    <!DOCTYPE html>
    <html lang="en" xmlns="http://www.w3.org/1999/xhtml">
      <head>
        <title>Run Homarr Application Dashboard on Windows</title>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
        <meta charset="UTF-8">
        <meta name="keywords" content="Browser Based,Home Lab,Home Lab Ideas,Install Guide,Web Based,Web Based Tools,Application Dashboard,Home Lab Dashboard,Homelab,Homepage,Homarr Application Dashboard,Windows,Microsoft Windows,NodeJS,NPM,Homarr,How To,Tutorial,i12bretro">
        <meta name="author" content="i12bretro">
        <meta name="description" content="Run Homarr Application Dashboard on Windows">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta name="revised" content="02/11/2024 06:07:00 AM" />
				          <link rel="icon" type="image/x-icon" href="includes/favicon.ico">
				  <script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.min.js"></script>
				        <script type="text/javascript" src="includes/js/steps.js"></script>
        <link href="css/steps.css" rel="stylesheet" type="text/css" />
      </head>
      <body>
        <div id="gridContainer">
          <div class="topMargin"></div>
          <div id="listName" class="topMargin">
            <h1>Run Homarr Application Dashboard on Windows</h1>
          </div>
          <div></div>
          <div id="content">
          <h2>What is Homarr?</h2>

<p><em>Simplify the management of your server with Homarr - a sleek, modern dashboard that puts all of your apps and services at your fingertips. With Homarr, you can access and control everything in one convenient location. Homarr seamlessly integrates with the apps you&#39;ve added, providing you with valuable information and giving you complete control. Installation is a breeze, and Homarr supports a wide range of deployment methods.</em> -<a href="https://github.com/ajnart/homarr" target="_blank">https://github.com/ajnart/homarr</a></p>

<h2>Installing Homarr</h2>

<ol>
	<li>Log into the Windows device</li>
	<li>Download the latest Homarr release <a href="https://github.com/ajnart/homarr/releases/latest" target="_blank">Download</a></li>
	<li>Download NodeJS <a href="https://nodejs.org/en/download/current/" target="_blank">Download</a></li>
	<li>Install NodeJS &gt; During the install, make sure to check the Tools for Native Modules option</li>
	<li>At the Native Modules prompt, press any key to begin the installation process<br />
	<span style="font-size:12px;"><em>NOTE: This process takes quite a while to install, be patient. Proceed once the PowerShell window closes</em></span></li>
	<li>Extract the downloaded Homarr files</li>
	<li>Rename the extracted folder homarr</li>
	<li>Cut the homarr folder to a location it can safely run from, C:\Program Files\homarr in this example</li>
	<li>Click on the Start menu &gt; type cmd &gt; Right click on Command Prompt &gt; Run as administrator</li>
	<li>Run the following commands in the Command Prompt window
	<div class="codeBlock CMD"># change directory to homarr, C:\Program Files\homarr in this example<br />
	cd %programfiles%\homarr<br />
	# update npm<br />
	npm install -g npm<br />
	# install yarn<br />
	npm install -g yarn<br />
	# fix dependencies<br />
	yarn install<br />
	# create .env file from example<br />
	copy .\.env.example .\.env<br />
	# build homarr<br />
	yarn build<br />
	# migrate database schema<br />
	yarn db:migrate<br />
	# run homarr<br />
	yarn start</div>
	</li>
	<li>Open a web browser and navigate to http://DNSorIP:3000</li>
	<li>Click the Start update process button</li>
	<li>Select Standalone Linux / Windows &gt; Click Continue</li>
	<li>Enter an admin username and enter and confirm a password &gt; Click Continue</li>
	<li>Click the Go to your board button</li>
	<li>Welcome to Homarr</li>
</ol>

<h2>Run Homarr on System Startup (Optional, but recommended)</h2>

<ol>
	<li>Press CTRL + C to kill the running Homarr process</li>
	<li>Open a text editor and paste the following
	<p>:: Start homarr server<br />
	cd /D &quot;%~dp0&quot;<br />
	start &quot;homarr&quot; /b npm start</p>
	</li>
	<li>Save the file as homarr.bat in the homarr directory, C:\Program Files\homarr in this example</li>
	<li>Click on the Start Button &gt; Type task &gt; Launch Task Scheduler</li>
	<li>Right click the Task Scheduler Library folder in the left pane &gt; Create Basic Task...</li>
	<li>Set the name to Homarr and optionally set a Description &gt; Click Next</li>
	<li>For the Trigger, select When the computer starts &gt; Click Next</li>
	<li>For the Action, select Start a program &gt; Click Next</li>
	<li>Complete the form fields as follows:
	<p>Program/script: &quot;%ProgramFiles%\homarr\homarr.bat&quot;<br />
	Add arguments:<br />
	Start in:</p>
	</li>
	<li>Click Next</li>
	<li>Check the Open the Properties dialog checkbox &gt; Click Finish</li>
	<li>In the Properties dialog, click the Change User or Group... button</li>
	<li>Type System in the Object name field &gt; Click OK</li>
	<li>Check the Run with highest privileges box</li>
	<li>Click OK to create the scheduled task</li>
	<li>Right click the Homarr task &gt; Run</li>
	<li>Refresh the open web browser to verify Homarr is now running from the scheduled task</li>
</ol>

<p>Source: <a href="https://homarr.dev/docs/getting-started/installation/" target="_blank">https://homarr.dev/docs/getting-started/installation/</a></p>          </div>
        </div>
      </body>
    </html>