User management
Info
This page goes over how to perform actions which require an administrator account on Pterodactyl. This is not the same as simply having an account.
Adding a new user¶
- Log into the panel at https://edcgaming.org.
- Click the cog icon on the top right to access the administrative section of Pterodactyl.
- Select
Usersfrom the left side-bar. - Click the blue
Create Newbutton on the top right of the user table.
You should now see a form.
Permission Field
Setting the Administrator permission to Yes grants the user account the ability to manipulate users, servers, and eggs without restriction. This should not be given in most circumstances.
| Field | Instructions |
|---|---|
Provide any string that represents a valid email (e.g <text>@<text>.com). This does not need to be real, but should be legible, as the email is how access to servers is changed. |
|
| Username | Their typical online handle. No capital letters. |
| Client First Name | Unfortunately required, but can be anything.1 |
| Client Last Name | Unfortunately required, but can be anything.1 |
| Default Language | Leave as is. |
| Permissions — Administrator | Grant with caution. See the warning above this table. |
| Password | Provide any string as a temporary password.2 This field includes an informational box that says setting a temporary password is not required. Ignore it. |
Once done, click the green Create User button. The account now exists.
Give the temporary password to the user in any reasonable way. Strongly advise them to change the password immediately.
You may optionally warn the user that they must setup 2-factor authentication in order for them to be able to do anything. This is a Pterodactyl-wide setting and is enforced even if the user is given access to a server; buttons will just not function.
Resetting a password¶
Pterodactyl cannot send password reset emails as the backend does not have an email server setup. Passwords must be reset manually.
- Log into the panel at https://edcgaming.org.
- Click the cog icon on the top right to access the administrative section of Pterodactyl.
- Select
Usersfrom the left side-bar. - Click the email of the user in question.
- Provide a string to act as the temporary password in the
Passwordfield. - Click the blue
Update Userbutton.
Their password has now changed. Communicate the temporary password to the user in any reasonable way.
Deleting a user¶
Warning
The button to delete a user takes effect immediately. You will want to double check you have selected the right user.
Note that if the target user is set as the owner of any server they cannot be deleted. You will need to remove them as the owner of the relevant servers before proceeding.
- Log into the panel at https://edcgaming.org.
- Click the cog icon on the top right to access the administrative section of Pterodactyl.
- Select
Usersfrom the left side-bar. - Click the email of the user in question.
- Click the red
Delete Userbutton.
The user is now deleted.
Giving access to server¶
Any user set as a server's owner automatically has access to it. This section will go over giving other users access to a server.
- Log into the panel at https://edcgaming.org.
- Navigate to the server.
- Method A
- After logging in, in the list of available servers, click the name of the one in question.
- Method B
- Click the cog icon on the top right to access the administrative section of Pterodactyl.
- Select
Serversfrom the left side-bar. - Click the name of the server in question.
- Click the tab.
- Method A
- Click the
Userstab. - Click the blue
New Userbutton. - In the
User Emailfield, search for the user by email, then select them.
The rest of the options are assigning permissions. Give what seems reasonable.
Sensitive Permissions
The following permissions should be given cautiously.
| Category | Permission(s) | Rationale |
|---|---|---|
| User | Create, Update, Delete | Generally speaking, only panel administrators should be deciding who has access to what. |
| Allocation | Create, Update, Delete | Ports are confusing for most people and servers are very picky about them. Mistakenly changing the port can cause confusion and take time to fix. |
| Settings | Reinstall | Reinstallation results in irrecoverable file deletion. This should be reserved for the user primarily managing the server. |
-
Common practice is to split the username in the middle or, if the username consists of multiple nouns, seperate them (e.g
SierraKomodoSierra,Komodo|SirdogSir,Dog). ↩↩ -
While not required, ideally, the temporary password you give should be strong in it's own right incase the user does not change it. ↩