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

Set the panel path for use throughout this guide

Set $PTERODACTYL_DIRECTORY

bash

# Use this command to set a $PTERODACTYL_DIRECTORY variable
# for use later in this guide.
export PTERODACTYL_DIRECTORY=/var/www/pterodactyl

Download Blueprint

Install prerequisites, then navigate and extract the latest release

Install curl, wget, unzip & download Blueprint

bash

# Install curl, wget and unzip if you haven't already
sudo apt install -y curl wget unzip
# 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 dependencies, Node 22.x repository, then yarn & node modules

Install dependencies, Node.js repo, yarn & modules

bash

# Install dependencies
sudo apt install -y ca-certificates curl git gnupg unzip wget zip
# Add Node.js apt repository
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
# cd into Pterodactyl, install yarn and node dependencies
cd $PTERODACTYL_DIRECTORY
npm i -g yarn
yarn install

Create .blueprintrc

Create the config file in your Pterodactyl directory

Create .blueprintrc config file

bash

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

Configure .blueprintrc

Write web server ownership and shell config values

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