Blueprint Installation

🧩 Blueprint must be installed after Pterodactyl Panel is already running. Complete the installation guide first if you haven't already.

Set Directory Variable & Install Prerequisites

Set the panel path and install curl, wget, unzip

Set $PTERODACTYL_DIRECTORY

bash

# Set a $PTERODACTYL_DIRECTORY variable for use throughout this guide
export PTERODACTYL_DIRECTORY=/var/www/pterodactyl

Install curl, wget, unzip

bash

sudo apt install -y curl wget unzip

Download Blueprint

Navigate to panel directory and extract the latest release

Navigate & download Blueprint release

bash

# Navigate to your Pterodactyl directory
cd $PTERODACTYL_DIRECTORY
# Download and unzip Blueprint's latest release
wget "https://github.com/BlueprintFramework/framework/releases/latest/download/release.zip" -O "$PTERODACTYL_DIRECTORY/release.zip"
unzip -o release.zip

Install Node.js & Yarn

Add Node 22.x repository, install Node.js, then yarn

Install dependencies & add Node.js repo

bash

# Install dependencies
sudo apt install -y ca-certificates curl git gnupg unzip wget zip

Add Node.js apt repository (v22.x)

bash

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_22.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list
sudo apt update
sudo apt install -y nodejs

Install yarn & node dependencies

bash

# cd into Pterodactyl, install yarn and node dependencies
cd $PTERODACTYL_DIRECTORY
npm i -g yarn
yarn install

Configure Blueprint

Create .blueprintrc and write web server config

Create .blueprintrc config file

bash

# Creates a .blueprintrc file in your Pterodactyl directory
touch $PTERODACTYL_DIRECTORY/.blueprintrc

Write config values to .blueprintrc

bash

# Writes data to your .blueprintrc file
echo \
'WEBUSER="www-data";
OWNERSHIP="www-data:www-data";
USERSHELL="/bin/bash";' > $PTERODACTYL_DIRECTORY/.blueprintrc

Run Blueprint

Give execute permissions and launch the installer

Set permissions & run blueprint.sh

bash

# Give blueprint.sh execute permissions
chmod +x $PTERODACTYL_DIRECTORY/blueprint.sh
# Run blueprint.sh
bash $PTERODACTYL_DIRECTORY/blueprint.sh