Pterodactyl VPS Egg

A powerful and lightweight Virtual Private Server (VPS) egg for Pterodactyl Panel

Supporting multiple architectures and 20+ Linux distributions

📋 Quick Start • 🔧 Commands • 🔐 SSH Setup • 🤝 Contributing

---

✨ Features

• 🚀 Easy Deployment - One-click installation and setup
• 🔧 Customizable - Flexible configurations for various use cases
• 🏗️ Multi-Architecture - Support for AMD64, ARM64, and RISCV64
• 🐧 20+ Linux Distros - Wide range of operating systems supported
• 🔌 Port Management - TCP/UDP support with dynamic port mapping

🏗️ Supported Architectures

Architecture	Status	Notes
amd64	✅ Full Support	Recommended for most users
arm64	✅ Full Support	Ideal for ARM-based servers
riscv64	⚠️ Limited Support	Requires custom rootfs images

Important

For riscv64 architecture, you must provide or host your own rootfs images. Currently, only Chimera Linux offers native support for riscv64 in this egg.

Available Linux Distributions

• Rocky Linux
• AlmaLinux
• CentOS
• Oracle Linux
• Ubuntu
• Debian
• Kali Linux
• Devuan Linux
• Alpine Linux
• Arch Linux
• Gentoo Linux
• Void Linux
• Slackware Linux
• openSUSE
• Fedora
• Chimera Linux
• Amazon Linux
• Plamo Linux
• Linux Mint
• Alt Linux
• Funtoo Linux
• openEuler
• Springdale Linux

🚀 Quick Start

📥 Installation

1. Download the Egg

   • Download the egg-vps.json configuration file from this repository.

2. Import to Pterodactyl

   • Navigate to your Pterodactyl Admin Panel
   • Go to Nests > Import Egg
   • Upload the egg-vps.json file
   • Configure the egg settings as needed

3. Deploy Your VPS

   • Create a new server using the VPS egg
   • Configure system resources (RAM, CPU, Disk, etc.)
   • Start your instance

🖥️ First Steps

Once your VPS is running:

1. Access the Console - Use the Pterodactyl web console to interact with your VPS
2. Run help - View all available custom commands
3. Customize Settings - Configure your environment as needed

🔧 Available Custom Commands

The VPS egg includes several built-in commands to help you manage your server:

Command	Description	Usage
help	Display available commands	help
clear / cls	Clear the screen	clear or cls
exit	Shutdown the server	exit
history	Show command history	history
reinstall	Reinstall the operating system	reinstall
install-ssh	Install the custom SSH server	install-ssh
status	Show system status information	status
backup	Create a system backup	backup
restore	Restore a system backup	restore <backup_file>

Note

All commands are available immediately after the server starts. Use help to view this list anytime.

Warning

The reinstall command will completely wipe all data on the server. Use with caution.

🔐 SSH Configuration

Install the Custom SSH Server:

• After installing the desired distro, use the install-ssh command to install our custom SSH server.

Configuration Options

The configuration file is located at /ssh_config.yml and supports the following options:

SSH Options

Option	Description	Default
port	Port number for SSH server	2222
user	Username for SSH authentication	root
password	Password for SSH authentication (supports plain text or bcrypt hash)	password
timeout	Connection timeout in seconds (comment out or set to 0 to disable)	300

SFTP Options

Option	Description	Default
enable	Enable or disable SFTP support	true

Note

The timeout setting is optional and can be omitted from the configuration.

Warning

The default password "password" is insecure and MUST be changed immediately after installation for security reasons.

Example /ssh_config.yml Configuration

Here is an example configuration file:

ssh:
  port: "2222"
  user: "root"
  password: "password"
  # timeout: 30

sftp:
  enable: true

🤝 Contributing

Contributions are welcome! If you have any suggestions, improvements, or bug fixes, feel free to submit a pull request or open an issue.

How to Contribute

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is open-source and available under the MIT License. See the LICENSE file for more details.