GUIDE.md

The Pmteor Guide

• Installing Basic
• Installing from Source
• [Pmteor Env] (#pmteor-env)

Installing Basic

curl install.pmteor.com | sh

or other versions

curl install.pmteor.com/release/x.x.x | sh

Manual Installation Steps

Install Node.js

Make sure Node.js is installed (currently Version 0.10.XX is required). If you don't have this version, you can use the node packages.

Install MongoDB

In order to run Pmteor you need to have MongoDB installed. You can either install your distributions package, if they offer any or see the MongoDB website how to install it.

Install a Pmteor release

Now you need to download the release you want to install, usually this is the latest release which you can find here (you need the .tar.gz one).

Extract it:

tar xzvf pmteor-VERSION.tar.gz

Now go back to the base Pmteor bundle directory:

cd ../../

Now we just need to make some settings through env variables:

export MONGO_URL='mongodb://127.0.0.1:27017/pmteor'
export ROOT_URL='https://example.com'
export MAX_BUNDLE_SIZE=52428800
export PORT=8080

Now you are ready to run:

node main.js

Install manually from Source

This is the most complex way, suitable if you know what you are doing and want to have the most flexibility to adapt the installation to your needs. Let's go!

Install Node.js

If you haven't already, you need to install Node.js, given that we need node version 0.10.XX, make sure to either use the custom packages (the ones of your OS are likely too old) or install the correct version from the Node.js website.

Install Meteor

As you might have noticed already, Pmteor is built using the Meteor web framework, so we need to install this as well. This can be done easily using their install script (read it if you don't trust it):

# This will install Meteor to ~/.meteor
curl https://install.meteor.com/ | sh

Install MongoDB

In order to run Pmteor you need to have MongoDB installed. You can either install your distributions package, if they offer any or see the MongoDB website how to install it.

Download and build Pmteor

First we need to get the latest version of Pmteor and change to the cloned folder:

git clone https://github.com/pmteor/pmteor.git && cd pmteor

Now we need to build the meteor app:

meteor build .build --directory

We use .build here, as it will be ignored by meteor on subsequent builds, you can as well use a directory outside the pmteor folder.

Now we need to cd into the build server folder and install some dependencies:

cd .build/bundle/programs/server/ && sudo npm install

Now we need to set some environment variables:

export MONGO_URL='mongodb://127.0.0.1:27017/pmteor'
export ROOT_URL='https://example.com'
export MAX_BUNDLE_SIZE=52428800
export PORT=8080

Most of them should be self-explaining. After having set the variables, let's move back to the build package folder and start the server:

cd ../../../
node main.js

Done!

Pmteor Env

Export variables must be set before one runs Meteor and after Pmteor can be started.

BUNDLE_DIR

Location of the folder where user applications will be uploaded and stored. Default Development(/tmp/bundles)

MAX_BUNDLE_SIZE Required Production

It sets the file upload limit. Default Development(50 * 1024 * 1024) "50 MB"