GitHub|Since 2007
WPTR
Documentation

Server Installation & Deployment

Quick Setup
$npx create-next-app@latest my-headless-site
$cd my-headless-site
$git clone https://github.com/Turkeyseo/headless-wordpress .
$npm install
$npm run build && npm start

💡 Click the button above to copy all commands

Production Ready Installation

Follow these steps to deploy your Headless WordPress site on your server (VPS, Cloud, or Hosting).

Prerequisites

Ensure your server has the following installed:

  • Node.js (v18.17+)
  • npm or yarn
  • Git

Step 1: Create Project Structure

Run the following command to initialize the project:

npx create-next-app@latest my-headless-site

Select the recommended options (TypeScript, ESLint, Tailwind CSS, App Router).

Step 2: Navigate to Directory

cd my-headless-site

Step 3: Clone System Files

Integrate the headless system into your project:

git clone https://github.com/Turkeyseo/headless-wordpress .

Step 4: Install Dependencies

npm install

Step 5: Build for Production

Compile the application for optimal performance:

npm run build

Step 6: Start the Server

Launch your application in production mode:

npm start

Your application is now running on port 3000.

Step 7: Automated Setup Wizard

Open your browser and navigate to your site URL (e.g., https://your-domain.com). You will be automatically redirected to the Setup Wizard.

The system will handle all configuration automatically:

  • Connecting to your WordPress site
  • Generating environment variables
  • Configuring site settings

Note: For a permanent setup, it is recommended to use a process manager like PM2: pm2 start npm --name 'headless-wp' -- start