Installing manually

No installer available for your platform? Did the installer fail? It is not your taste? YOLO? DIY!

Getting PHP for your server

  1. Download your flavor PHP binary (Downloads)
  2. Extract the PHP binary into your server directory. If everything went well, you should have a bin folder in your server directory.
  3. (Windows only) Download and install Microsoft Visual C++ Redistributable 2017 (Downloads)

Getting PocketMine-MP

Using .phar

  1. Create a new directory for PocketMine-MP.
  2. Download PocketMine-MP.phar (Downloads)
  3. Rename the .phar to PocketMine-MP.phar.
  4. Place it in the PocketMine-MP directory you just created.
  5. Get the start script for your platform (Windows CMD, Windows PowerShell, Linux/MacOS bash)
  6. (Linux/MacOS only) Make executable (chmod +x

Using Git

You can also run PocketMine-MP from source code by cloning the GitHub repository using Git.

PocketMine-MP uses Composer to manage its library dependencies. Composer is shipped with our prebuilt PHP packages, but if you want to install it manually, you can do so at

Clone the repository (recursively, to include submodules):

git clone --recursive # don't forget the --recursive flag!

Install dependencies using Composer

  • Basic version:

    path/to/php path/to/composer.phar install
  • or, if you have a global Composer installation:

    composer install
  • or, if you’re using a prebuilt PHP provided by PMMP, a wrapper for Composer is provided:

    bin/composer install

If you’re running a production server, you might want to skip dev dependencies and generate a faster autoloader:

bin/composer install --no-dev --classmap-authoritative

See the docs at for more information on using Composer.


Remember to clone with the --recursive flag! PocketMine-MP has several submodules which are required to run the server.

If you forgot the --recursive flag when you cloned, you can cd into the server directory and run git submodule update --init --recursive.


If running a production server, consider using a phar instead for better performance.