0ct0pu5
/
tutorials


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
							    <!DOCTYPE html>
    <html lang="en" xmlns="http://www.w3.org/1999/xhtml">
      <head>
        <title>Running Homepage Application Dashboard Using Docker</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,Self-Hosted,Web Based,Web Based Tools,Application Dashboard,Homelab Dashboard,Homepage,Homepage Application Dashboard,Linux,NodeJS,Ubuntu,Docker,Docker Container,Docker How To,Docker Made Easy,Docker Simplified,Docker Tutorial,Homelab,How To,Tutorial,i12bretro">
        <meta name="author" content="i12bretro">
        <meta name="description" content="Running Homepage Application Dashboard Using Docker">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta name="revised" content="01/12/2024 07:13:45 PM" />
				          <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>Running Homepage Application Dashboard Using Docker</h1>
          </div>
          <div></div>
          <div id="content">
          <h2>What is Homepage?</h2>

<blockquote><em>[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. -<a href="https://github.com/benphelps/homepage" target="_blank">https://github.com/benphelps/homepage</a></em></blockquote>

<h2>Installing Docker</h2>

<ol>
	<li>Log into the Linux Docker host and run the following commands in a terminal window
	<div class="codeBlock"># install prerequisites<br />
	sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y<br />
	# add docker gpg key<br />
	curl -fsSL https://download.docker.com/linux/$(awk -F&#39;=&#39; &#39;/^ID=/{ print $NF }&#39; /etc/os-release)/gpg | sudo apt-key add -<br />
	# add docker software repository<br />
	sudo add-apt-repository &quot;deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F&#39;=&#39; &#39;/^ID=/{ print $NF }&#39; /etc/os-release) $(lsb_release -cs) stable&quot;<br />
	# install docker<br />
	sudo apt install docker-ce docker-compose containerd.io -y<br />
	# enable and start docker service<br />
	sudo systemctl enable docker &amp;&amp; sudo systemctl start docker<br />
	# add the current user to the docker group<br />
	sudo usermod -aG docker $USER<br />
	# reauthenticate for the new group membership to take effect<br />
	su - $USER</div>
	</li>
</ol>

<h2>Running Homepage Application Dashboard</h2>

<ol>
	<li>Continue with the following commands in a terminal window
	<div class="codeBlock"># list current uid and gid, note these for later<br />
	id $user<br />
	# make a homepage directory to mount in the container<br />
	mkdir ~/homepage -p<br />
	# run the homepage docker image<br />
	# replace PUID, GUID with the output of the id $user command above<br />
	docker run -d --name=homepage -e PUID=1000 -e PGID=1000 -p 8006:3000 -v ~/homepage:/app/config -v /var/run/docker.sock:/var/run/docker.sock --restart unless-stopped ghcr.io/benphelps/homepage</div>
	</li>
	<li>Open a web browser and navigate to http://DNSorIP:8006</li>
</ol>

<p>Source: <a href="https://gethomepage.dev/en/installation/docker" target="_blank">https://gethomepage.dev/en/installation/docker</a></p>          </div>
        </div>
      </body>
    </html>