documentation/daemon/0.6/debian_8_docker.html
2021-03-06 20:07:21 +00:00

75 lines
21 KiB
HTML

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Docker on Debian 8 | Pterodactyl</title>
<meta name="generator" content="VuePress 1.8.2">
<link rel="apple-touch-icon" sizes="180x180" href="/favicons/apple-touch-icon.png">
<link rel="icon" type="image/png" href="/favicons/favicon-32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="/favicons/favicon-16x16.png" sizes="16x16">
<link rel="mask-icon" href="/favicons/safari-pinned-tab.svg" color="#0e4688">
<link rel="manifest" href="/favicons/site.webmanifest">
<link rel="shortcut icon" href="/favicons/favicon.ico">
<meta name="description" content="Pterodactyl is an open-source game server management panel built with PHP 7, React, and Go. Designed with security in mind, Pterodactyl runs all game servers in isolated Docker containers while exposing a beautiful and intuitive UI to end users.">
<meta name="msapplication-config" content="/favicons/browserconfig.xml">
<meta name="theme-color" content="#0e4688">
<link rel="preload" href="/assets/css/0.styles.b4cb0fef.css" as="style"><link rel="preload" href="/assets/js/app.f655d56c.js" as="script"><link rel="preload" href="/assets/js/4.9dfb277d.js" as="script"><link rel="preload" href="/assets/js/1.d0c981d7.js" as="script"><link rel="preload" href="/assets/js/48.0bb564a9.js" as="script"><link rel="prefetch" href="/assets/js/10.27cec751.js"><link rel="prefetch" href="/assets/js/11.53217705.js"><link rel="prefetch" href="/assets/js/12.6783fda9.js"><link rel="prefetch" href="/assets/js/13.bd04c4ec.js"><link rel="prefetch" href="/assets/js/14.2e96f1b8.js"><link rel="prefetch" href="/assets/js/15.a6802091.js"><link rel="prefetch" href="/assets/js/16.f2dea920.js"><link rel="prefetch" href="/assets/js/17.8289ca23.js"><link rel="prefetch" href="/assets/js/18.fcb158a9.js"><link rel="prefetch" href="/assets/js/19.bb80f931.js"><link rel="prefetch" href="/assets/js/2.21e1a937.js"><link rel="prefetch" href="/assets/js/20.d065b2c5.js"><link rel="prefetch" href="/assets/js/21.61865717.js"><link rel="prefetch" href="/assets/js/22.3ff292b3.js"><link rel="prefetch" href="/assets/js/23.6b778859.js"><link rel="prefetch" href="/assets/js/24.18e132d5.js"><link rel="prefetch" href="/assets/js/25.5a8ed612.js"><link rel="prefetch" href="/assets/js/26.0b63e77f.js"><link rel="prefetch" href="/assets/js/27.0711df74.js"><link rel="prefetch" href="/assets/js/28.17b33d85.js"><link rel="prefetch" href="/assets/js/29.9c25f524.js"><link rel="prefetch" href="/assets/js/30.34c4472a.js"><link rel="prefetch" href="/assets/js/31.4a35c00f.js"><link rel="prefetch" href="/assets/js/32.d98a3373.js"><link rel="prefetch" href="/assets/js/33.88a8819c.js"><link rel="prefetch" href="/assets/js/34.0edc39f4.js"><link rel="prefetch" href="/assets/js/35.969d92c8.js"><link rel="prefetch" href="/assets/js/36.49b831e2.js"><link rel="prefetch" href="/assets/js/37.46d8127b.js"><link rel="prefetch" href="/assets/js/38.9d9c367c.js"><link rel="prefetch" href="/assets/js/39.4e9577b6.js"><link rel="prefetch" href="/assets/js/40.273f9b41.js"><link rel="prefetch" href="/assets/js/41.32790d14.js"><link rel="prefetch" href="/assets/js/42.d9689e6d.js"><link rel="prefetch" href="/assets/js/43.9992155a.js"><link rel="prefetch" href="/assets/js/44.e7f6dd0e.js"><link rel="prefetch" href="/assets/js/45.32b9b890.js"><link rel="prefetch" href="/assets/js/46.c04b0749.js"><link rel="prefetch" href="/assets/js/47.8a528b5d.js"><link rel="prefetch" href="/assets/js/49.70313a9d.js"><link rel="prefetch" href="/assets/js/5.73a53d7a.js"><link rel="prefetch" href="/assets/js/50.6b4f4718.js"><link rel="prefetch" href="/assets/js/51.75e9c6d8.js"><link rel="prefetch" href="/assets/js/52.5803bd20.js"><link rel="prefetch" href="/assets/js/53.c0284790.js"><link rel="prefetch" href="/assets/js/54.14aa3f16.js"><link rel="prefetch" href="/assets/js/55.4e7ca13f.js"><link rel="prefetch" href="/assets/js/56.cbbea30d.js"><link rel="prefetch" href="/assets/js/57.7fee903e.js"><link rel="prefetch" href="/assets/js/58.df220808.js"><link rel="prefetch" href="/assets/js/59.06f08aee.js"><link rel="prefetch" href="/assets/js/6.8999fd8a.js"><link rel="prefetch" href="/assets/js/60.a3853cbe.js"><link rel="prefetch" href="/assets/js/61.360ebc59.js"><link rel="prefetch" href="/assets/js/62.db0d6812.js"><link rel="prefetch" href="/assets/js/63.8a89fed0.js"><link rel="prefetch" href="/assets/js/64.8fe43c5c.js"><link rel="prefetch" href="/assets/js/65.d4df1bb2.js"><link rel="prefetch" href="/assets/js/66.6f45bd01.js"><link rel="prefetch" href="/assets/js/67.178227eb.js"><link rel="prefetch" href="/assets/js/68.0031d838.js"><link rel="prefetch" href="/assets/js/69.74d5f183.js"><link rel="prefetch" href="/assets/js/7.9f1ce256.js"><link rel="prefetch" href="/assets/js/70.baf1e400.js"><link rel="prefetch" href="/assets/js/71.6037dd5b.js"><link rel="prefetch" href="/assets/js/72.be219eed.js"><link rel="prefetch" href="/assets/js/73.11b803e4.js"><link rel="prefetch" href="/assets/js/74.282a4100.js"><link rel="prefetch" href="/assets/js/75.87d47714.js"><link rel="prefetch" href="/assets/js/76.b8ec6c02.js"><link rel="prefetch" href="/assets/js/77.771256d6.js"><link rel="prefetch" href="/assets/js/78.36c13dcb.js"><link rel="prefetch" href="/assets/js/8.4c71898e.js"><link rel="prefetch" href="/assets/js/9.7af626f7.js">
<link rel="stylesheet" href="/assets/css/0.styles.b4cb0fef.css">
</head>
<body>
<div id="app" data-server-rendered="true"><div class="theme-container"><header class="nav"><div class="sidebar-button block md:hidden flex-no-shrink"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewBox="0 0 448 512" class="icon"><path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path></svg></div> <div class="logo-container"><a href="/" class="home-link router-link-active"><img src="/logos/pterry.svg" class="logo"> <span class="site-name hidden md:inline can-hide">Pterodactyl</span></a></div> <div class="w-full"><div class="flex"><div class="search-box"><input aria-label="Search" placeholder="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links flex-no-shrink hidden md:flex"><div class="nav-item"><a href="/project/introduction.html" class="nav-link">Documentation
</a></div><div class="nav-item"><a href="/community/about.html" class="nav-link">Community Guides
</a></div><div class="nav-item"><a href="https://discord.gg/pterodactyl" target="_blank" rel="noopener noreferrer" class="nav-link external">
Get Help
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></div><div class="nav-item"><a href="https://dashflo.net/docs/api/pterodactyl/v1/" target="_blank" rel="noopener noreferrer" class="nav-link external">
API
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
Contribute
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></div></nav></div></div></header> <div class="sidebar-mask"></div> <div class="sidebar"><nav class="nav-links flex-no-shrink block md:hidden"><div class="nav-item"><a href="/project/introduction.html" class="nav-link">Documentation
</a></div><div class="nav-item"><a href="/community/about.html" class="nav-link">Community Guides
</a></div><div class="nav-item"><a href="https://discord.gg/pterodactyl" target="_blank" rel="noopener noreferrer" class="nav-link external">
Get Help
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></div><div class="nav-item"><a href="https://dashflo.net/docs/api/pterodactyl/v1/" target="_blank" rel="noopener noreferrer" class="nav-link external">
API
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
Contribute
<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></div></nav> <ul class="sidebar-links"><li><div class="sidebar-group first"><p class="sidebar-heading open"><span>Project Information</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/project/introduction.html" class="sidebar-link">Introduction</a></li><li><a href="/project/about.html" class="sidebar-link">About</a></li><li><a href="/project/terms.html" class="sidebar-link">Terminology</a></li><li><a href="/project/community.html" class="sidebar-link">Community Standards</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Panel</span> <!----> <div tabindex="0" class="version-select custom-select float-right"><div class="selected"><div class="inline-block">
1.3
<span class="rounded-full ml-2 text-green-dark">current</span></div> <span class="arrow"></span></div> <div class="items hidden"><div class="item"><div class="inline-block">
1.3
<span class="rounded-full ml-2 text-green-dark">current</span></div></div></div></div></p> <ul class="sidebar-group-items"><li><a href="/panel/1.0/getting_started.html" class="sidebar-link">Getting Started</a></li><li><a href="/panel/1.0/webserver_configuration.html" class="sidebar-link">Webserver Configuration</a></li><li><a href="/panel/1.0/additional_configuration.html" class="sidebar-link">Additional Configuration</a></li><li><a href="/panel/1.0/updating.html" class="sidebar-link">Updating the Panel</a></li><li><a href="/panel/1.0/troubleshooting.html" class="sidebar-link">Troubleshooting</a></li><li><a href="/panel/1.0/legacy_upgrade.html" class="sidebar-link">Legacy Upgrades</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Wings</span> <!----> <div tabindex="0" class="version-select custom-select float-right"><div class="selected"><div class="inline-block">
1.3
<span class="rounded-full ml-2 text-green-dark">current</span></div> <span class="arrow"></span></div> <div class="items hidden"><div class="item"><div class="inline-block">
1.3
<span class="rounded-full ml-2 text-green-dark">current</span></div></div></div></div></p> <ul class="sidebar-group-items"><li><a href="/wings/1.0/installing.html" class="sidebar-link">Installing Wings</a></li><li><a href="/wings/1.0/upgrading.html" class="sidebar-link">Upgrading Wings</a></li><li><a href="/wings/1.0/migrating.html" class="sidebar-link">Migrating to Wings</a></li><li><a href="/wings/1.0/configuration.html" class="sidebar-link">Additional Configuration</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Tutorials</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/tutorials/mysql_setup.html" class="sidebar-link">Setting up MySQL</a></li><li><a href="/tutorials/creating_ssl_certificates.html" class="sidebar-link">Creating SSL Certificates</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Guides</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/guides/mounts.html" class="sidebar-link">Using Mounts</a></li></ul></div></li><li><div class="sidebar-group collapsable"><p class="sidebar-heading"><span>Development &amp; Ops</span> <span class="arrow right"></span> <!----></p> <!----></div></li></ul> </div> <div class="page"> <div class="content content__default"><h1 id="docker-on-debian-8"><a href="#docker-on-debian-8" class="header-anchor">#</a> Docker on Debian 8</h1> <p></p><div class="table-of-contents"><ul><li><a href="#install-docker">Install Docker</a></li><li><a href="#update-grub-startup">Update GRUB Startup</a></li><li><a href="#add-backports-repo">Add Backports Repo</a></li><li><a href="#update-software-setup-docker">Update Software &amp; Setup Docker</a></li></ul></div><p></p> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>There is a potential for broken software after this upgrade as we are moving to a non-stable kernel (in regards
to mainline Debian). Please take backups and only proceed if you are comfortable with this process.</p></div> <h2 id="install-docker"><a href="#install-docker" class="header-anchor">#</a> Install Docker</h2> <p>To begin with, we're going to install docker just like we would for any other OS by following Docker's
<a href="https://docs.docker.com/install/linux/docker-ce/debian/#install-docker-ce" target="_blank" rel="noopener noreferrer">official documentation for Debian<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>.</p> <p>Once you've done that, if you run <code>docker info</code> you'll notice some missing features at the bottom, something
like the output below.</p> <div class="language-text extra-class"><pre class="language-text"><code>WARNING: No memory limit support
WARNING: No swap limit support
WARNING: No kernel memory limit support
WARNING: No oom kill disable support
WARNING: No cpu cfs quota support
WARNING: No cpu cfs period support
</code></pre></div><h2 id="update-grub-startup"><a href="#update-grub-startup" class="header-anchor">#</a> Update GRUB Startup</h2> <p>To fix the memory limit support issues, we just need to add two arguments to our default grub startup. Start by
opening <code>/etc/default/grub</code> and adding the following arguments to <code>GRUB_CMDLINE_LINUX_DEFAULT</code>.</p> <div class="language-text extra-class"><pre class="language-text"><code>swapaccount=1 cgroup_enable=memory
</code></pre></div><p>The line should then look like the one below — assuming nothing else was in the quote to begin with.</p> <div class="language-text extra-class"><pre class="language-text"><code>GRUB_CMDLINE_LINUX_DEFAULT=&quot;swapaccount=1 cgroup_enable=memory&quot;
</code></pre></div><p>After doing that, run <code>sudo update-grub</code> to update our grub configuration.</p> <h2 id="add-backports-repo"><a href="#add-backports-repo" class="header-anchor">#</a> Add Backports Repo</h2> <p>We then need to enable the <code>jessie-backports</code> apt repository to install a newer kernel. To do this, run the commands below.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token builtin class-name">echo</span> deb http://http.debian.net/debian jessie-backports main <span class="token operator">&gt;</span> /etc/apt/sources.list.d/jessie-backports.list
<span class="token builtin class-name">echo</span> deb http://http.debian.net/debian jessie-backports main contrib non-free <span class="token operator">&gt;</span> /etc/apt/sources.list.d/jessie-backports.list
<span class="token function">sudo</span> <span class="token function">apt</span> update
</code></pre></div><p>To find the most recent kernels, run <code>apt-cache search linux-image</code> which will list all of the ones available. In this
case, we'll install the <code>4.9.0</code> kernel using the command below. Once we've done that, it is time to reboot the server
to start using this kernel.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">apt</span> <span class="token function">install</span> -t jessie-backports linux-image-4.9.0-0.bpo.3-amd64
<span class="token function">reboot</span>
</code></pre></div><h2 id="update-software-setup-docker"><a href="#update-software-setup-docker" class="header-anchor">#</a> Update Software &amp; Setup Docker</h2> <p>Now that we're on the new kernel you probably need to update some software to take advantage of it. To do this,
simply run the command below.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">apt</span> update <span class="token operator">&amp;&amp;</span> <span class="token function">apt</span> upgrade
</code></pre></div><p>Once that is done, we need to make an adjustment to docker to use <code>overlay2</code> rather than <code>aufs</code> since <code>aufs</code> is not
supported on this kernel currently. Run the command below to do so.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">sed</span> -i <span class="token string">'s,/usr/bin/dockerd,/usr/bin/dockerd --storage-driver=overlay2,g'</span> /lib/systemd/system/docker.service
</code></pre></div><p>Finally, update <code>systemd</code> and start docker using the following commands.</p> <div class="language-bash extra-class"><pre class="language-bash"><code>systemctl daemon-reload
<span class="token function">service</span> docker start
</code></pre></div><p>Docker should now be running and reporting no errors if you run <code>docker info</code>!</p></div> <div class="page-edit"><div class="edit-link"><a href="https://github.com/pterodactyl/documentation/edit/master/daemon/0.6/debian_8_docker.md" target="_blank" rel="noopener noreferrer">Help us improve this page.</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <!----></div> <!----> </div></div><div class="global-ui"></div></div>
<script src="/assets/js/app.f655d56c.js" defer></script><script src="/assets/js/4.9dfb277d.js" defer></script><script src="/assets/js/1.d0c981d7.js" defer></script><script src="/assets/js/48.0bb564a9.js" defer></script>
</body>
</html>