Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
My first Pancake
Clone this wiki locally
You want to install and use Pancake. That's a good decision. But how? This is a small tutorial on how to get started with Pancake.
Step 1: Meet the system requirements
Pancake needs three things to unfold its good taste: Linux, PHP and DeepTrace.
You can basically use any Linux distribution (for example Debian) for Pancake. If you don't want to use Linux at all, Pancake might also run under BSD or Darwin, but those systems are not officially supported. Under Microsoft Windows it won't work at all due to its missing POSIX-compliance.
For Pancake you need at least PHP 5.4.0, although PHP 5.4.10 or newer is recommended. The PHP-binary has to be compiled with the configure options "--enable-toenizer --enable-posix --enable-ctype". In most cases, any PHP you'll find in your operating system's repositories was compiled with these options, so you don't need to worry about recompiling PHP yourself.
Installing PHP from the OS's software repositories is easy.
Under Debian, Ubuntu, Mint (or any other apt-supporting distribution) just run
sudo apt-get install php5-cli
Some operating systems only provide quite old versions of PHP. In this cases it might be a good idea to look for other repositories. For apt-supporting distributions (like Debian) you might use Dotdeb. After having added the repository just run the command above. If you don't find any repositories with current PHP-versions you can either use the old version provided by your system's repository or you can compile PHP yourself. I won't describe here how to compile PHP as that would go too deep. You'll find tutorials on the WWW.
DeepTrace is an extension for the Zend Engine, the core of the PHP interpreter. It allows Pancake things like deleting functions or setting thread titles. Things that are needed to provide a clean SAPI for PHP. DeepTrace is bundled with Pancake for x86, x86_64 and ARM processors.
Step 2: Download and install Pancake
Over at pancakehttp.net you will always find the current Pancake release version. Download this version either using your browser or
After having downloaded Pancake as a tarball or zipball open a shell in the directory you've downloaded Pancake to and run the following commands:
tar -zxvf pp3345-Pancake-* for tarballs
unzip pp3345-Pancake-* for zipballs
sudo mkdir /usr/local/Pancake
sudo cp -r * /usr/local/Pancake
sudo chmod +x pancake.sh
It is recommended to use the official Pancake init script for Debian-based systems. See README.md for further instructions.
Step 3: Start Pancake for the first time
When using the init script, run
sudo /etc/init.d/pancake start. Else run the command
Now you can open your browser and go to http://localhost/ (or your servers IP address if you've installed Pancake on a remote server) and look at the amazing "Welcome to Pancake!" screen. :-)