49 lines
18 KiB
HTML

<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Creating a New Node | Pterodactyl</title>
<meta name="generator" content="VuePress 1.5.4">
<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/manifest.json">
<link rel="shortcut icon" href="/favicons/favicon.ico">
<meta name="description" content="The open-source server management solution.">
<meta name="msapplication-config" content="/favicons/browserconfig.xml">
<meta name="theme-color" content="#0e4688">
<link rel="preload" href="/assets/css/0.styles.affe18a7.css" as="style"><link rel="preload" href="/assets/js/app.79f90a8b.js" as="script"><link rel="preload" href="/assets/js/4.8ba07d01.js" as="script"><link rel="preload" href="/assets/js/1.ee4ff4e2.js" as="script"><link rel="preload" href="/assets/js/17.38ebdfd4.js" as="script"><link rel="prefetch" href="/assets/js/10.041c438a.js"><link rel="prefetch" href="/assets/js/11.efec8f80.js"><link rel="prefetch" href="/assets/js/12.8f07f9da.js"><link rel="prefetch" href="/assets/js/13.7b958e39.js"><link rel="prefetch" href="/assets/js/14.3700aaa2.js"><link rel="prefetch" href="/assets/js/15.c05cc168.js"><link rel="prefetch" href="/assets/js/16.90c5b55f.js"><link rel="prefetch" href="/assets/js/18.2e49d336.js"><link rel="prefetch" href="/assets/js/19.6f5573ce.js"><link rel="prefetch" href="/assets/js/2.f895a645.js"><link rel="prefetch" href="/assets/js/20.1bb23db3.js"><link rel="prefetch" href="/assets/js/21.41c0fcca.js"><link rel="prefetch" href="/assets/js/22.badcb70a.js"><link rel="prefetch" href="/assets/js/23.e5b12066.js"><link rel="prefetch" href="/assets/js/24.433197bc.js"><link rel="prefetch" href="/assets/js/25.f87fba53.js"><link rel="prefetch" href="/assets/js/26.e0451f04.js"><link rel="prefetch" href="/assets/js/27.778d7f34.js"><link rel="prefetch" href="/assets/js/28.653b63a6.js"><link rel="prefetch" href="/assets/js/29.895e3725.js"><link rel="prefetch" href="/assets/js/30.c937ce7b.js"><link rel="prefetch" href="/assets/js/31.7f511022.js"><link rel="prefetch" href="/assets/js/32.edb430bb.js"><link rel="prefetch" href="/assets/js/33.126692c0.js"><link rel="prefetch" href="/assets/js/34.db1f95ca.js"><link rel="prefetch" href="/assets/js/35.a76295a7.js"><link rel="prefetch" href="/assets/js/36.6c7ce3e9.js"><link rel="prefetch" href="/assets/js/37.acc05557.js"><link rel="prefetch" href="/assets/js/38.cbbc09bf.js"><link rel="prefetch" href="/assets/js/39.cdd96218.js"><link rel="prefetch" href="/assets/js/40.d602e7aa.js"><link rel="prefetch" href="/assets/js/41.d2ca8a7c.js"><link rel="prefetch" href="/assets/js/42.872a4cc6.js"><link rel="prefetch" href="/assets/js/43.4694115c.js"><link rel="prefetch" href="/assets/js/44.aba1c9a7.js"><link rel="prefetch" href="/assets/js/45.43535f37.js"><link rel="prefetch" href="/assets/js/46.177ea9d9.js"><link rel="prefetch" href="/assets/js/47.f6f5e305.js"><link rel="prefetch" href="/assets/js/48.014f3e64.js"><link rel="prefetch" href="/assets/js/49.22a383a0.js"><link rel="prefetch" href="/assets/js/5.1bddf890.js"><link rel="prefetch" href="/assets/js/50.43c0500a.js"><link rel="prefetch" href="/assets/js/51.b86f952d.js"><link rel="prefetch" href="/assets/js/52.9a78fb3a.js"><link rel="prefetch" href="/assets/js/53.c01cdedb.js"><link rel="prefetch" href="/assets/js/54.cccda0e8.js"><link rel="prefetch" href="/assets/js/55.0ceb7c03.js"><link rel="prefetch" href="/assets/js/56.ee8fe752.js"><link rel="prefetch" href="/assets/js/57.63fb8da1.js"><link rel="prefetch" href="/assets/js/58.8850932d.js"><link rel="prefetch" href="/assets/js/59.e2119e73.js"><link rel="prefetch" href="/assets/js/6.d7837586.js"><link rel="prefetch" href="/assets/js/60.d509d6cc.js"><link rel="prefetch" href="/assets/js/61.7e7949af.js"><link rel="prefetch" href="/assets/js/62.cbeb1945.js"><link rel="prefetch" href="/assets/js/63.9a9642cb.js"><link rel="prefetch" href="/assets/js/64.b899f18b.js"><link rel="prefetch" href="/assets/js/65.8a452d1d.js"><link rel="prefetch" href="/assets/js/66.b5eb6f83.js"><link rel="prefetch" href="/assets/js/67.1dc632b6.js"><link rel="prefetch" href="/assets/js/68.9aad69bf.js"><link rel="prefetch" href="/assets/js/69.9cdc147c.js"><link rel="prefetch" href="/assets/js/7.e7575cc8.js"><link rel="prefetch" href="/assets/js/70.ba33f507.js"><link rel="prefetch" href="/assets/js/71.e87b1de3.js"><link rel="prefetch" href="/assets/js/72.e692ccfa.js"><link rel="prefetch" href="/assets/js/73.41d4e536.js"><link rel="prefetch" href="/assets/js/8.f208d3ff.js"><link rel="prefetch" href="/assets/js/9.56fc48a0.js">
<link rel="stylesheet" href="/assets/css/0.styles.affe18a7.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="/pterodactyl-flat.png" 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://pterodactyl.io/discord" target="_blank" rel="noopener noreferrer" class="nav-link external">
Get Help
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
Contribute
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></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://pterodactyl.io/discord" target="_blank" rel="noopener noreferrer" class="nav-link external">
Get Help
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></a></div> <div class="nav-item"><a href="https://github.com/pterodactyl/panel" target="_blank" rel="noopener noreferrer" class="nav-link">
Contribute
<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></a></div></nav> <ul class="sidebar-links"><li><div class="sidebar-group first"><p class="sidebar-heading"><span>Community Guides</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/community/about.html" class="sidebar-link">Community Guides and Tutorials</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Panel Installation</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/community/installation-guides/panel/centos7.html" class="sidebar-link">CentOS 7</a></li><li><a href="/community/installation-guides/panel/centos8.html" class="sidebar-link">CentOS 8</a></li><li><a href="/community/installation-guides/panel/debian9.html" class="sidebar-link">Debian 9</a></li><li><a href="/community/installation-guides/panel/debian10.html" class="sidebar-link">Debian 10</a></li><li><a href="/community/installation-guides/panel/ubuntu1804.html" class="sidebar-link">Ubuntu 18.04</a></li><li><a href="/community/installation-guides/panel/ubuntu2004.html" class="sidebar-link">Ubuntu 20.04</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Daemon Installation</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/community/installation-guides/daemon/centos7.html" class="sidebar-link">CentOS 7</a></li><li><a href="/community/installation-guides/daemon/centos8.html" class="sidebar-link">CentOS 8</a></li><li><a href="/community/installation-guides/daemon/debian9.html" class="sidebar-link">Debian 9</a></li><li><a href="/community/installation-guides/daemon/debian10.html" class="sidebar-link">Debian 10</a></li><li><a href="/community/installation-guides/daemon/ubuntu1804.html" class="sidebar-link">Ubuntu 18.04</a></li><li><a href="/community/installation-guides/daemon/ubuntu2004.html" class="sidebar-link">Ubuntu 20.04</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Creating Eggs</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/community/config/eggs/creating_a_custom_egg.html" class="sidebar-link">Creating a Custom Egg</a></li><li><a href="/community/config/eggs/creating_a_custom_image.html" class="sidebar-link">Creating a Custom Docker Image</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading"><span>Game Configuration</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/community/games/minecraft.html" class="sidebar-link">Minecraft</a></li></ul></div></li><li><div class="sidebar-group"><p class="sidebar-heading open"><span>Tutorials</span> <!----> <!----></p> <ul class="sidebar-group-items"><li><a href="/community/config/nodes/add_node.html" class="active sidebar-link">Creating a New Node</a><ul class="sidebar-sub-headers"><li class="sidebar-sub-header"><a href="/community/config/nodes/add_node.html#location" class="sidebar-link">Location</a></li><li class="sidebar-sub-header"><a href="/community/config/nodes/add_node.html#information-required" class="sidebar-link">Information Required</a></li><li class="sidebar-sub-header"><a href="/community/config/nodes/add_node.html#install-the-daemon" class="sidebar-link">Install the Daemon</a></li><li class="sidebar-sub-header"><a href="/community/config/nodes/add_node.html#configuring-the-node" class="sidebar-link">Configuring the Node</a></li></ul></li><li><a href="/community/tutorials/custom_theme_setup.html" class="sidebar-link">Creating a theme for Pterodactyl</a></li><li><a href="/community/tutorials/artisan.html" class="sidebar-link">Artisan CLI</a></li></ul></div></li></ul> </div> <div class="page"> <div class="content content__default"><h1 id="creating-a-new-node"><a href="#creating-a-new-node" class="header-anchor">#</a> Creating a New Node</h1> <p></p><div class="table-of-contents"><ul><li><a href="#location">Location</a></li><li><a href="#information-required">Information Required</a></li><li><a href="#install-the-daemon">Install the Daemon</a></li><li><a href="#configuring-the-node">Configuring the Node</a><ul><li><a href="#auto-deploy">Auto-Deploy</a></li></ul></li></ul></div><p></p> <h2 id="location"><a href="#location" class="header-anchor">#</a> Location</h2> <p>Head to the admin panel and click the Nodes tab on the left sidebar. After that, click 'Create New' on the
top right side to open the page to add a node.</p> <p><img src="/assets/img/pterodactyl_add_node_create_button.1a29979f.png" alt=""></p> <h2 id="information-required"><a href="#information-required" class="header-anchor">#</a> Information Required</h2> <p><img src="/assets/img/pterodactyl_add_node_new_page.f359059a.png" alt=""></p> <ul><li><strong>Name</strong>: a quick identifiable name for the daemon</li> <li><strong>Description</strong>: a long description that is used to help you identify the node.</li> <li><strong>Location</strong>: the location you have the node in. These are configured in the 'Locations' section of the panel and one
must be created before a node can be created. These simply act as categories for Nodes and serve no other purpose at
this time.</li> <li><strong>FQDN</strong>: the fully qualified domain name for the node — for example: <code>node.demon.pterodactyl.io</code></li> <li><strong>Communicate over SSL</strong>: if the panel is using SSL the Daemon is required to use SSL as well.</li> <li><strong>Behind Proxy</strong>: if you have the daemon behind a proxy that terminates SSL connections before arriving at the daemon
then this option should be selected. If none of that sentence made sense, this doesn't effect you.</li> <li><strong>Server File Directory</strong>: the location on the physical server where the daemon is to store the files the servers
generate. By default this is <code>/srv/daemon-data</code>.</li></ul> <div class="custom-block tip"><p class="custom-block-title">OVH Users</p> <p>Some OVH users regularly have their <code>/home</code> folder be the largest filesystem. You may want to change to use
<code>/home/daemon-data</code> if you are on a default OVH box.</p></div> <ul><li><strong>Total Memory</strong>: the total amount of ram the Node should be able to allocate automatically.</li> <li><strong>Memory Overallocate</strong>: the percentage of ram to over-allocate on a Node. For example, if you have set a 10G memory
limit, with a 20% overallocation the Panel will allocate up to 12G of memory on this node in total.</li> <li><strong>Total Disk Space</strong>: the totaly amount of ram the Node should be able to allocate automatically.</li> <li><strong>Disk Overallocate</strong>: works the same way as memory overallocation.</li></ul> <div class="custom-block danger"><p class="custom-block-title">DANGER</p> <p>Don't forget to account for OS overhead and other software requirements on machines.</p></div> <ul><li><strong>Daemon Port</strong>: the port that the Daemon should listen on.</li> <li><strong>Daemon SFTP Port</strong>: the port the daemon sftp-server or standalone SFTP server listen on.</li></ul> <h2 id="install-the-daemon"><a href="#install-the-daemon" class="header-anchor">#</a> Install the Daemon</h2> <p>At this point you'll need to have the daemon installed on your machine. Check out the <a href="/daemon/installing.html">documentation</a>
for more information, or try one of the community guides for <a href="/community/installation-guides/daemon/centos7.html">CentOS</a>,
<a href="/community/installation-guides/daemon/ubuntu1804.html">Ubuntu</a>, or <a href="/community/installation-guides/daemon/debian9.html">Debian</a>.</p> <h2 id="configuring-the-node"><a href="#configuring-the-node" class="header-anchor">#</a> Configuring the Node</h2> <p>Go to the Node Configuration page</p> <p><img src="/assets/img/pterodactyl_add_node_config.6ae87ba2.png" alt=""></p> <p>Copy and paste the config into the <code>core.json</code> folder. (Default location is <code>/srv/daemon/config/core.json</code>)</p> <h3 id="auto-deploy"><a href="#auto-deploy" class="header-anchor">#</a> Auto-Deploy</h3> <p>This will generate a command to run on the node server to configure the daemon for you. (This needs to be run in the <code>/srv/daemon</code> folder)</p></div> <div class="page-edit"><div class="edit-link"><a href="https://github.com/pterodactyl/documentation/edit/master/community/config/nodes/add_node.md" target="_blank" rel="noopener noreferrer">Help us improve this page.</a> <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" 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></div> <!----></div> <div class="page-nav"><p class="inner"></p> <div class="prev"><span>
<a href="/community/games/minecraft.html">Minecraft</a></span></div> <div class="next"><span><a href="/community/tutorials/custom_theme_setup.html">Creating a theme for Pterodactyl</a>
</span></div></div> </div></div><div class="global-ui"></div></div>
<script src="/assets/js/app.79f90a8b.js" defer></script><script src="/assets/js/4.8ba07d01.js" defer></script><script src="/assets/js/1.ee4ff4e2.js" defer></script><script src="/assets/js/17.38ebdfd4.js" defer></script>
</body>
</html>