253 lines
No EOL
12 KiB
HTML
253 lines
No EOL
12 KiB
HTML
<!doctype html>
|
|
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
|
|
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
|
|
<!--[if IE 8]> <html class="no-js lt-ie9"> <![endif]-->
|
|
<!--[if gt IE 8]><!--> <html> <!--<![endif]-->
|
|
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
|
|
<title>Installation on Docker - Home Assistant</title>
|
|
<meta name="author" content="Home Assistant">
|
|
<meta name="description" content="Instructions to install Home Assistant on a Docker.">
|
|
|
|
<meta name="viewport" content="width=device-width">
|
|
<link rel="canonical" href="https://home-assistant.io/getting-started/installation-docker/">
|
|
|
|
<meta property="fb:app_id" content="338291289691179">
|
|
<meta property="og:title" content="Installation on Docker">
|
|
<meta property="og:site_name" content="Home Assistant">
|
|
<meta property="og:url" content="https://home-assistant.io/getting-started/installation-docker/">
|
|
<meta property="og:type" content="website">
|
|
<meta property="og:description" content="Instructions to install Home Assistant on a Docker.">
|
|
<meta property="og:image" content="https://home-assistant.io/images/default-social.png">
|
|
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:site" content="@home_assistant">
|
|
|
|
<meta name="twitter:title" content="Installation on Docker">
|
|
<meta name="twitter:description" content="Instructions to install Home Assistant on a Docker.">
|
|
<meta name="twitter:image" content="https://home-assistant.io/images/default-social.png">
|
|
|
|
<link href="/stylesheets/screen.css" media="screen, projection" rel="stylesheet">
|
|
<link href="/atom.xml" rel="alternate" title="Home Assistant" type="application/atom+xml">
|
|
<link rel='shortcut icon' href='/images/favicon.ico' />
|
|
<link rel='icon' type='image/png' href='/images/favicon-192x192.png' sizes='192x192' />
|
|
</head>
|
|
|
|
<body >
|
|
|
|
<header>
|
|
<div class="grid-wrapper">
|
|
<div class="grid">
|
|
|
|
<div class="grid__item three-tenths lap-two-sixths palm-one-whole ha-title">
|
|
<a href="/" class="site-title">
|
|
<img width='40' src='/demo/favicon-192x192.png'>
|
|
<span>Home Assistant</span>
|
|
</a>
|
|
</div>
|
|
|
|
<div class="grid__item seven-tenths lap-four-sixths palm-one-whole">
|
|
<nav>
|
|
<input type="checkbox" id="toggle">
|
|
<label for="toggle" class="toggle" data-open="Main Menu" data-close="Close Menu"></label>
|
|
<ul class="menu pull-right">
|
|
|
|
<li><a href="/getting-started/">Getting started</a></li>
|
|
<li><a href="/components/">Components</a></li>
|
|
<li><a href="/ecosystem/">Ecosystem</a></li>
|
|
<li><a href="/cookbook/">Examples</a></li>
|
|
<li><a href="/developers/">Developers</a></li>
|
|
<li><a href="/blog/">Blog</a></li>
|
|
<li><a href="/help/">Need help?</a></li>
|
|
</ul>
|
|
</nav>
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
</header>
|
|
|
|
|
|
|
|
<div class="grid-wrapper">
|
|
<div class="grid grid-center">
|
|
|
|
<div class="grid__item two-thirds lap-one-whole palm-one-whole">
|
|
|
|
|
|
<article class="page">
|
|
|
|
|
|
|
|
|
|
<header>
|
|
<h1 class="title indent">
|
|
Installation on Docker
|
|
</h1>
|
|
</header>
|
|
<hr class="divider">
|
|
|
|
|
|
<p>Installation with Docker is straightforward. Adjust the following command so that <code class="highlighter-rouge">/path/to/your/config/</code> points at the folder where you want to store your config and run it:</p>
|
|
|
|
<div class="language-bash highlighter-rouge"><pre class="highlight"><code><span class="gp">$ </span>docker run -d --name<span class="o">=</span><span class="s2">"home-assistant"</span> -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --net<span class="o">=</span>host homeassistant/home-assistant
|
|
</code></pre>
|
|
</div>
|
|
|
|
<p>This will launch Home Assistant and serve the web interface from port 8123 on your Docker host.</p>
|
|
|
|
<p class="note">
|
|
When using boot2docker on OS X you are unable to map the local time to your Docker container. Replace <code class="highlighter-rouge">-v /etc/localtime:/etc/localtime:ro</code> with <code class="highlighter-rouge">-e "TZ=America/Los_Angeles"</code> (replacing America/Los_Angeles with <a href="http://en.wikipedia.org/wiki/List_of_tz_database_time_zones">your timezone</a>)
|
|
|
|
Additionally, if your expectation is that you will be able to browse directly to <code class="highlighter-rouge">http://localhost:8123</code> on your OS X host, then you will also need to replace the <code class="highlighter-rouge">--net=host</code> switch with <code class="highlighter-rouge">-p 8123:8123</code>. This is currently the only way to forward ports on to your actual host(OS X) machine instead of the virtual machine inside xhyve. More detail on this can be found in <a href="https://forums.docker.com/t/should-docker-run-net-host-work/14215/10">the docker forums</a>.
|
|
</p>
|
|
|
|
<p>If you change the config you have to restart the server.
|
|
To do that you have 2 options.</p>
|
|
|
|
<ol>
|
|
<li>You can go to the <img src="/images/screenshots/developer-tool-services-icon.png" alt="service developer tool icon" class="no-shadow" height="38" /> service developer tools, select the service <code class="highlighter-rouge">homeassistant/restart</code> and click “Call Service”.</li>
|
|
<li>Or you can restart it from an terminal by running <code class="highlighter-rouge">docker restart home-assistant</code></li>
|
|
</ol>
|
|
|
|
<h3><a class="title-link" name="troubleshooting" href="#troubleshooting"></a> Troubleshooting</h3>
|
|
|
|
<p>If you run into any issues, please see <a href="/getting-started/troubleshooting/">the troubleshooting page</a>. It contains solutions to many of the more commonly encountered issues.</p>
|
|
|
|
<p>In addition to this site, check out these sources for additional help:</p>
|
|
|
|
<ul>
|
|
<li><a href="https://community.home-assistant.io">Forum</a> for Home Assistant discussions and questions.</li>
|
|
<li><a href="https://gitter.im/home-assistant/home-assistant">Gitter Chat Room</a> for real-time chat about Home Assistant.</li>
|
|
<li><a href="https://github.com/home-assistant/home-assistant/issues">GitHub Page</a> for issue reporting.</li>
|
|
</ul>
|
|
|
|
<h3><a href="/getting-started/configuration/">Next step: Configuring Home Assistant »</a></h3>
|
|
|
|
|
|
</article>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">
|
|
<div class="grid">
|
|
|
|
|
|
<section class="aside-module grid__item one-whole lap-one-half">
|
|
<div class='edit-github'><a href='https://github.com/home-assistant/home-assistant.github.io/tree/current/source/getting-started/installation-docker.markdown'>Edit this page on GitHub</a></div>
|
|
<div class='section'>
|
|
<h1 class="title delta">Getting Started Guide</h1>
|
|
<ul class='divided sidebar-menu'>
|
|
<li>
|
|
<a href='/getting-started/'>Installation </a>
|
|
<ul>
|
|
<li><a href='/getting-started/installation-python/'>Python </a></li>
|
|
<li><a href='/getting-started/updating/'>Updating </a></li>
|
|
<li><a href='/getting-started/troubleshooting/'>Troubleshooting </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/getting-started/hassbian/'>Hassbian </a>
|
|
<ul>
|
|
<li><a href='/getting-started/hassbian-installation/'>Installation </a></li>
|
|
<li><a href='/getting-started/hassbian-customization/'>Customization </a></li>
|
|
<li><a href='/getting-started/hassbian-common-tasks/'>Common tasks </a></li>
|
|
<li><a href='/getting-started/hassbian-integrations/'>Integrations </a></li>
|
|
<li><a href='/getting-started/hassbian-upgrading/'>Upgrading </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/getting-started/configuration/'>Configuration </a>
|
|
<ul>
|
|
<li><a href='/getting-started/yaml/'>YAML </a></li>
|
|
<li><a href='/getting-started/basic/'>Basic information </a></li>
|
|
<li><a href='/getting-started/devices/'>Setting up devices </a></li>
|
|
<li><a href='/getting-started/customizing-devices/'>Customizing devices and services </a></li>
|
|
<li><a href='/getting-started/presence-detection/'>Presence Detection </a></li>
|
|
<li><a href='/getting-started/troubleshooting-configuration/'>Troubleshooting </a></li>
|
|
<li><a href='/getting-started/securing/'>Security Check Points </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/getting-started/automation/'>Automation </a>
|
|
<ul>
|
|
<li><a href='/getting-started/automation-create-first/'>Tutorial </a></li>
|
|
<li><a href='/getting-started/automation-trigger/'>Triggers </a></li>
|
|
<li><a href='/getting-started/automation-condition/'>Conditions </a></li>
|
|
<li><a href='/getting-started/automation-action/'>Actions </a></li>
|
|
<li><a href='/getting-started/automation-templating/'>Templates </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/getting-started/scripts/'>Scripts </a>
|
|
<ul>
|
|
<li><a href='/getting-started/scripts-service-calls/'>Service Calls </a></li>
|
|
<li><a href='/getting-started/scripts-conditions/'>Conditions </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/getting-started/z-wave/'>Z-Wave </a>
|
|
<ul>
|
|
<li><a href='/getting-started/z-wave-controllers/'>Controllers </a></li>
|
|
<li><a href='/getting-started/z-wave-settings/'>Modifying Settings </a></li>
|
|
<li><a href='/getting-started/z-wave-device-specific/'>Device Specific </a></li>
|
|
</ul>
|
|
</li>
|
|
<li>
|
|
<a href='/getting-started/autostart/'>Autostart </a>
|
|
<ul>
|
|
<li><a href='/getting-started/autostart-systemd/'>Linux - systemd </a></li>
|
|
<li><a href='/getting-started/autostart-upstart/'>Linux - Upstart </a></li>
|
|
<li><a href='/getting-started/autostart-init.d/'>Linux - init.d </a></li>
|
|
<li><a href='/getting-started/autostart-macos/'>macOS </a></li>
|
|
<li><a href='/getting-started/autostart-synology/'>Synology NAS </a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href='/topics/'>Advanced Topics </a></li>
|
|
<li><a href='/details/'>Details </a></li>
|
|
<li><a href='/getting-started/mobile/'>Add to Android/iOS Homescreen </a></li>
|
|
<li><a href='/getting-started/browsers/'>Browser Compatibility List </a></li>
|
|
</ul>
|
|
</div>
|
|
</section>
|
|
|
|
</div>
|
|
</aside>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<footer>
|
|
<div class="grid-wrapper">
|
|
<div class="grid">
|
|
<div class="grid__item">
|
|
<div class="copyright">
|
|
<a rel="me" href='https://twitter.com/home_assistant'><i class="icon-twitter"></i></a>
|
|
<a rel="me" href='https://facebook.com/homeassistantio'><i class="icon-facebook"></i></a>
|
|
<a rel="me" href='https://plus.google.com/110560654828510104551'><i class="icon-google-plus"></i></a>
|
|
<a rel="me" href='https://github.com/home-assistant/home-assistant'><i class="icon-github"></i></a>
|
|
|
|
<div class="credit">
|
|
Contact us at <a href='mailto:hello@home-assistant.io'>hello@home-assistant.io</a>.<br>
|
|
Website powered by <a href='http://jekyllrb.com/'>Jekyll</a> and the <a href='https://github.com/coogie/oscailte'>Oscalite theme</a>.<br />
|
|
Hosted by <a href='https://pages.github.com/'>GitHub</a> and served by <a href='https://cloudflare.com'>CloudFlare</a>.
|
|
</div>
|
|
<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a><br /><span xmlns:dct="http://purl.org/dc/terms/" property="dct:title">home-assistant.io</span> is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License</a>.
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</footer>
|
|
|
|
<script>
|
|
var _gaq=[['_setAccount','UA-57927901-1'],['_trackPageview']];
|
|
(function(d,t){var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
|
|
g.src=('https:'==location.protocol?'//ssl':'//www')+'.google-analytics.com/ga.js';
|
|
s.parentNode.insertBefore(g,s)}(document,'script'));
|
|
</script>
|
|
</body>
|
|
</html> |