Using Mounts

Introduction

A mount makes a directory on the node available inside a server's container, for example to share a large map, a mod pack, or plugins between servers without copying them into each one.

A mount has a source, the directory on the node, and a target, the path where it appears inside the container.

Allowing the Directory in Wings

For security, Wings only mounts directories listed under allowed_mounts in /etc/pterodactyl/config.yml:

allowed_mounts:
  - /var/lib/pterodactyl/mounts

Add each mount's source directory to this list yourself, then restart Wings:

systemctl restart wings

A directory in allowed_mounts also allows every directory inside it.

Creating a Mount

Open Admin → Mounts, click New Mount, and fill in:

• Name: A unique name.
• Description: Optional notes.
• Source: The absolute path of the directory on the node, such as /var/lib/pterodactyl/mounts/maps. Create the directory on each node you attach the mount to.
• Target: The absolute path inside the container, such as /home/container/maps. It cannot be /home/container itself.
• Read Only: Whether servers can only read the mount's files.
• User Mountable: Not used yet. Users cannot add mounts to their own servers; only administrators can attach mounts.

Click Create Mount. On the mount's page, use Attach Eggs and Attach Nodes to choose where it may be used. A server can only use a mount attached to both its egg and its node.

Attaching a Mount to a Server

1. Open the server in Admin → Servers and select its Mounts tab. The tab appears once the server is installed.
2. Click Mount next to the mount.
3. Restart the server.

The mount's files appear at the target path when the server starts. To remove the mount, click Unmount and restart the server.