mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-10 00:09:39 -06:00
96 lines
28 KiB
HTML
96 lines
28 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en-US">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>Installing Wings | Pterodactyl</title>
|
|
<meta name="generator" content="VuePress 1.9.10">
|
|
<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, 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.894cd3e9.css" as="style"><link rel="preload" href="/assets/js/app.747e3783.js" as="script"><link rel="preload" href="/assets/js/4.1c05de3a.js" as="script"><link rel="preload" href="/assets/js/2.638bc23b.js" as="script"><link rel="preload" href="/assets/js/15.c66c8d6e.js" as="script"><link rel="prefetch" href="/assets/js/1.364681bc.js"><link rel="prefetch" href="/assets/js/10.08b9c98e.js"><link rel="prefetch" href="/assets/js/11.e264572d.js"><link rel="prefetch" href="/assets/js/12.a4261b01.js"><link rel="prefetch" href="/assets/js/13.43a16fbd.js"><link rel="prefetch" href="/assets/js/14.65d10cad.js"><link rel="prefetch" href="/assets/js/16.80d778f6.js"><link rel="prefetch" href="/assets/js/17.aa66495a.js"><link rel="prefetch" href="/assets/js/18.57b733fd.js"><link rel="prefetch" href="/assets/js/19.ec92bd63.js"><link rel="prefetch" href="/assets/js/20.5c80f685.js"><link rel="prefetch" href="/assets/js/21.aecdb4c4.js"><link rel="prefetch" href="/assets/js/22.c4d3c3e7.js"><link rel="prefetch" href="/assets/js/23.4a3e5e0b.js"><link rel="prefetch" href="/assets/js/24.14d17171.js"><link rel="prefetch" href="/assets/js/25.b2ca157b.js"><link rel="prefetch" href="/assets/js/26.55d35d4f.js"><link rel="prefetch" href="/assets/js/27.005f34ff.js"><link rel="prefetch" href="/assets/js/28.a5eb93d2.js"><link rel="prefetch" href="/assets/js/29.173d87c8.js"><link rel="prefetch" href="/assets/js/30.2d8ee53c.js"><link rel="prefetch" href="/assets/js/31.1a5025b8.js"><link rel="prefetch" href="/assets/js/32.f259a483.js"><link rel="prefetch" href="/assets/js/33.d38817c1.js"><link rel="prefetch" href="/assets/js/34.49d78ff7.js"><link rel="prefetch" href="/assets/js/35.a04be06d.js"><link rel="prefetch" href="/assets/js/36.d63650be.js"><link rel="prefetch" href="/assets/js/37.e0153b42.js"><link rel="prefetch" href="/assets/js/38.059a51d4.js"><link rel="prefetch" href="/assets/js/39.942d570b.js"><link rel="prefetch" href="/assets/js/40.34edc760.js"><link rel="prefetch" href="/assets/js/41.368a213d.js"><link rel="prefetch" href="/assets/js/42.ea03a576.js"><link rel="prefetch" href="/assets/js/43.74132eec.js"><link rel="prefetch" href="/assets/js/44.a7d15b9f.js"><link rel="prefetch" href="/assets/js/45.638b4daf.js"><link rel="prefetch" href="/assets/js/46.b6984e9b.js"><link rel="prefetch" href="/assets/js/47.0f24220f.js"><link rel="prefetch" href="/assets/js/48.c19ab66e.js"><link rel="prefetch" href="/assets/js/49.69c43084.js"><link rel="prefetch" href="/assets/js/5.8c798c34.js"><link rel="prefetch" href="/assets/js/50.0b4f4dc4.js"><link rel="prefetch" href="/assets/js/51.f11b077a.js"><link rel="prefetch" href="/assets/js/52.8e320849.js"><link rel="prefetch" href="/assets/js/53.709f014a.js"><link rel="prefetch" href="/assets/js/54.d6bff428.js"><link rel="prefetch" href="/assets/js/55.a226dbb6.js"><link rel="prefetch" href="/assets/js/56.f682278e.js"><link rel="prefetch" href="/assets/js/57.5d950550.js"><link rel="prefetch" href="/assets/js/58.6917e3e6.js"><link rel="prefetch" href="/assets/js/59.74ce363c.js"><link rel="prefetch" href="/assets/js/6.cd87a2b3.js"><link rel="prefetch" href="/assets/js/60.6b0c08aa.js"><link rel="prefetch" href="/assets/js/61.d30789b5.js"><link rel="prefetch" href="/assets/js/62.1fef16a5.js"><link rel="prefetch" href="/assets/js/63.dfe26c31.js"><link rel="prefetch" href="/assets/js/64.58b54b08.js"><link rel="prefetch" href="/assets/js/65.372034bb.js"><link rel="prefetch" href="/assets/js/66.69a87c64.js"><link rel="prefetch" href="/assets/js/67.275f5b02.js"><link rel="prefetch" href="/assets/js/68.66b31eec.js"><link rel="prefetch" href="/assets/js/69.3809eab0.js"><link rel="prefetch" href="/assets/js/7.f17059bf.js"><link rel="prefetch" href="/assets/js/70.cbd191fe.js"><link rel="prefetch" href="/assets/js/71.e6dd244d.js"><link rel="prefetch" href="/assets/js/8.758e7e8b.js"><link rel="prefetch" href="/assets/js/9.3e9e31a6.js">
|
|
<link rel="stylesheet" href="/assets/css/0.styles.894cd3e9.css">
|
|
</head>
|
|
<body>
|
|
<div id="app" data-server-rendered="true"><div><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">
|
|
GitHub
|
|
<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">
|
|
GitHub
|
|
<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.11
|
|
<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.11
|
|
<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.11
|
|
<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.11
|
|
<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" aria-current="page" class="active sidebar-link">Installing Wings</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/wings/1.0/installing.html#supported-systems" class="sidebar-link">Supported Systems</a></li><li class="sidebar-sub-header"><a href="/wings/1.0/installing.html#system-requirements" class="sidebar-link">System Requirements</a></li><li class="sidebar-sub-header"><a href="/wings/1.0/installing.html#dependencies" class="sidebar-link">Dependencies</a></li><li class="sidebar-sub-header"><a href="/wings/1.0/installing.html#installing-wings-2" class="sidebar-link">Installing Wings</a></li><li class="sidebar-sub-header"><a href="/wings/1.0/installing.html#configure" class="sidebar-link">Configure</a></li></ul></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></ul> </div> <div class="page"> <div class="content content__default"><h1 id="installing-wings"><a href="#installing-wings" class="header-anchor">#</a> Installing Wings</h1> <p>Wings is the next generation server control plane from Pterodactyl. It has been rebuilt from the
|
|
ground up using Go and lessons learned from our first Nodejs Daemon.</p> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>You should only install Wings if you are running <strong>Pterodactyl 1.x</strong>. Do not install this software
|
|
for previous versions of Pterodactyl.</p></div> <h2 id="supported-systems"><a href="#supported-systems" class="header-anchor">#</a> Supported Systems</h2> <p>The following is a list of supported operating systems. Please be aware that this is not an exhaustive list,
|
|
there is a high probability that you can run the software on other Linux distributions without much effort.
|
|
You are responsible for determining which packages may be necessary on those systems. There is also a very
|
|
high probability that new releases of the supported OSes below will work just fine, you are not restricted to
|
|
only the versions listed below.</p> <table><thead><tr><th>Operating System</th> <th>Version</th> <th style="text-align:center;">Supported</th> <th>Notes</th></tr></thead> <tbody><tr><td><strong>Ubuntu</strong></td> <td>20.04</td> <td style="text-align:center;">✅</td> <td>Documentation written assuming Ubuntu 20.04 as the base OS.</td></tr> <tr><td></td> <td>22.04</td> <td style="text-align:center;">✅</td> <td></td></tr> <tr><td></td> <td>24.04</td> <td style="text-align:center;">✅</td> <td></td></tr> <tr><td><strong>RHEL / Rocky Linux / AlmaLinux</strong></td> <td>8</td> <td style="text-align:center;">✅</td> <td></td></tr> <tr><td></td> <td>9</td> <td style="text-align:center;">✅</td> <td></td></tr> <tr><td><strong>Debian</strong></td> <td>11</td> <td style="text-align:center;">✅</td> <td></td></tr> <tr><td></td> <td>12</td> <td style="text-align:center;">✅</td> <td></td></tr> <tr><td><strong>Windows</strong></td> <td>All</td> <td style="text-align:center;">❌</td> <td>This software will not run in Windows environments.</td></tr></tbody></table> <h2 id="system-requirements"><a href="#system-requirements" class="header-anchor">#</a> System Requirements</h2> <p>To run Wings, you will need a Linux system capable of running Docker containers. Most VPS and almost all
|
|
dedicated servers should be capable of running Docker, but there are edge cases.</p> <p>When your provider uses <code>Virtuozzo</code>, <code>OpenVZ</code> (or <code>OVZ</code>), or <code>LXC</code> virtualization, you will most likely be unable to
|
|
run Wings. Some providers have made the necessary changes for nested virtualization to support Docker. Ask your provider's support team to make sure. KVM is guaranteed to work.</p> <p>The easiest way to check is to type <code>systemd-detect-virt</code>.
|
|
If the result doesn't contain <code>OpenVZ</code> or<code>LXC</code>, it should be fine. The result of <code>none</code> will appear when running dedicated hardware without any virtualization.</p> <p>Should that not work for some reason, or you're still unsure, you can also run the command below.</p> <div class="language-bash extra-class"><pre class="language-bash"><code>dane@pterodactyl:~$ <span class="token function">sudo</span> dmidecode <span class="token parameter variable">-s</span> system-manufacturer
|
|
VMware, Inc.
|
|
</code></pre></div><h2 id="dependencies"><a href="#dependencies" class="header-anchor">#</a> Dependencies</h2> <ul><li>curl</li> <li>Docker</li></ul> <h3 id="installing-docker"><a href="#installing-docker" class="header-anchor">#</a> Installing Docker</h3> <p>For a quick install of Docker CE, you can execute the command below:</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">curl</span> <span class="token parameter variable">-sSL</span> https://get.docker.com/ <span class="token operator">|</span> <span class="token assign-left variable">CHANNEL</span><span class="token operator">=</span>stable <span class="token function">bash</span>
|
|
</code></pre></div><p>If you would rather do a manual installation, please reference the <a href="https://docs.docker.com/engine/install/" target="_blank" rel="noopener noreferrer">official Docker documentation<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> for how to install Docker CE on your server.</p> <div class="custom-block warning"><p class="custom-block-title">Check your Kernel</p> <p>Please be aware that some hosts install a modified kernel that does not support important docker features. Please
|
|
check your kernel by running <code>uname -r</code>. If your kernel ends in <code>-xxxx-grs-ipv6-64</code> or <code>-xxxx-mod-std-ipv6-64</code> you're
|
|
probably using a non-supported kernel. Check our <a href="/daemon/0.6/kernel_modifications.html">Kernel Modifications</a> guide for details.</p></div> <h4 id="start-docker-on-boot"><a href="#start-docker-on-boot" class="header-anchor">#</a> Start Docker on Boot</h4> <p>If you are on an operating system with systemd (Ubuntu 16+, Debian 8+, CentOS 7+) run the command below to have Docker start when you boot your machine.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">sudo</span> systemctl <span class="token builtin class-name">enable</span> <span class="token parameter variable">--now</span> <span class="token function">docker</span>
|
|
</code></pre></div><h4 id="enabling-swap"><a href="#enabling-swap" class="header-anchor">#</a> Enabling Swap</h4> <p>On most systems, Docker will be unable to setup swap space by default. You can confirm this by running <code>docker info</code> and looking for the output of <code>WARNING: No swap limit support</code> near the bottom.</p> <p>Enabling swap is entirely optional, but we recommended doing it if you will be hosting for others and to prevent OOM errors.</p> <p>To enable swap, open <code>/etc/default/grub</code> as a root user and find the line starting with <code>GRUB_CMDLINE_LINUX_DEFAULT</code>. Make
|
|
sure the line includes <code>swapaccount=1</code> somewhere inside the double-quotes.</p> <p>After that, run <code>sudo update-grub</code> followed by <code>sudo reboot</code> to restart the server and have swap enabled.
|
|
Below is an example of what the line should look like, <em>do not copy this line verbatim. It often has additional OS-specific parameters.</em></p> <div class="language-text extra-class"><pre class="language-text"><code>GRUB_CMDLINE_LINUX_DEFAULT="swapaccount=1"
|
|
</code></pre></div><div class="custom-block tip"><p class="custom-block-title">GRUB Configuration</p> <p>Some Linux distros may ignore <code>GRUB_CMDLINE_LINUX_DEFAULT</code>. Therefore you might have to use <code>GRUB_CMDLINE_LINUX</code> instead should the default one not work for you.</p></div> <h2 id="installing-wings-2"><a href="#installing-wings-2" class="header-anchor">#</a> Installing Wings</h2> <p>The first step for installing Wings is to ensure we have the required directory structure setup. To do so,
|
|
run the commands below, which will create the base directory and download the wings executable.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">sudo</span> <span class="token function">mkdir</span> <span class="token parameter variable">-p</span> /etc/pterodactyl
|
|
<span class="token function">curl</span> <span class="token parameter variable">-L</span> <span class="token parameter variable">-o</span> /usr/local/bin/wings <span class="token string">"https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "<span class="token variable"><span class="token variable">$(</span><span class="token function">uname</span> <span class="token parameter variable">-m</span><span class="token variable">)</span></span>"</span> <span class="token operator">==</span> <span class="token string">"x86_64"</span> <span class="token punctuation">]</span><span class="token punctuation">]</span> <span class="token operator">&&</span> <span class="token builtin class-name">echo</span> <span class="token string">"amd64"</span> <span class="token operator">||</span> <span class="token builtin class-name">echo</span> <span class="token string">"arm64"</span><span class="token punctuation">)</span>"
|
|
<span class="token function">sudo</span> <span class="token function">chmod</span> u+x /usr/local/bin/wings
|
|
</code></pre></div><div class="custom-block warning"><p class="custom-block-title">OVH/SYS Servers</p> <p>If you are using a server provided by OVH or SoYouStart please be aware that your main drive space is probably allocated to
|
|
<code>/home</code>, and not <code>/</code> by default. Please consider using <code>/home/daemon-data</code> for server data. This can be easily
|
|
set when creating the node.</p></div> <h2 id="configure"><a href="#configure" class="header-anchor">#</a> Configure</h2> <p>Once you have installed Wings and the required components, the next step is to create a node on your installed Panel. Go to your Panel administrative view, select Nodes from the sidebar, and on the right side click Create New button.</p> <p>After you have created a node, click on it and there will be a tab called Configuration. Copy the code block content, paste it into a new file called <code>config.yml</code> in <code>/etc/pterodactyl</code> and save it.</p> <p>Alternatively, you can click on the Generate Token button, copy the bash command and paste it into your terminal.</p> <p><img src="/assets/img/wings_configuration_example.9f3fdd0b.png" alt="example image of wings configuration"></p> <div class="custom-block warning"><p class="custom-block-title">WARNING</p> <p>When your Panel is using SSL, the Wings must also have one created for its FQDN. See <a href="/tutorials/creating_ssl_certificates.html">Creating SSL Certificates</a> documentation page for how to create these certificates before continuing.</p></div> <h3 id="starting-wings"><a href="#starting-wings" class="header-anchor">#</a> Starting Wings</h3> <p>To start Wings, simply run the command below, which will start it in a debug mode. Once you confirmed that it is running without errors, use <code>CTRL+C</code> to terminate the process and daemonize it by following the instructions below. Depending on your server's internet connection pulling and starting Wings for the first time may take a few minutes.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">sudo</span> wings <span class="token parameter variable">--debug</span>
|
|
</code></pre></div><p>You may optionally add the <code>--debug</code> flag to run Wings in debug mode.</p> <h3 id="daemonizing-using-systemd"><a href="#daemonizing-using-systemd" class="header-anchor">#</a> Daemonizing (using systemd)</h3> <p>Running Wings in the background is a simple task, just make sure that it runs without errors before doing
|
|
this. Place the contents below in a file called <code>wings.service</code> in the <code>/etc/systemd/system</code> directory.</p> <div class="language-text extra-class"><pre class="language-text"><code>[Unit]
|
|
Description=Pterodactyl Wings Daemon
|
|
After=docker.service
|
|
Requires=docker.service
|
|
PartOf=docker.service
|
|
|
|
[Service]
|
|
User=root
|
|
WorkingDirectory=/etc/pterodactyl
|
|
LimitNOFILE=4096
|
|
PIDFile=/var/run/wings/daemon.pid
|
|
ExecStart=/usr/local/bin/wings
|
|
Restart=on-failure
|
|
StartLimitInterval=180
|
|
StartLimitBurst=30
|
|
RestartSec=5s
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
</code></pre></div><p>Then, run the commands below to reload systemd and start Wings.</p> <div class="language-bash extra-class"><pre class="language-bash"><code><span class="token function">sudo</span> systemctl <span class="token builtin class-name">enable</span> <span class="token parameter variable">--now</span> wings
|
|
</code></pre></div><h3 id="node-allocations"><a href="#node-allocations" class="header-anchor">#</a> Node Allocations</h3> <p>Allocation is a combination of IP and Port that you can assign to a server. Each created server must have at least one allocation. The allocation would be the IP address of your network interface. In some cases, such as when behind NAT, it would be the internal IP. To create new allocations go to Nodes > your node > Allocation.</p> <p><img src="/assets/img/node_allocations.323d67f2.png" alt="example image of node allocations"></p> <p>Type <code>hostname -I | awk '{print $1}'</code> to find the IP to be used for the allocation. Alternatively, you can type <code>ip addr | grep "inet "</code> to see all your available interfaces and IP addresses. Do not use 127.0.0.1 for allocations.</p></div> <div class="page-edit"><div class="edit-link"><a href="https://github.com/pterodactyl/documentation/edit/master/wings/1.0/installing.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><div class="global-ui"></div></div>
|
|
<script src="/assets/js/app.747e3783.js" defer></script><script src="/assets/js/4.1c05de3a.js" defer></script><script src="/assets/js/2.638bc23b.js" defer></script><script src="/assets/js/15.c66c8d6e.js" defer></script>
|
|
</body>
|
|
</html>
|