A complete guide to install Meteor App Telescope on Your Own Server

In this tutorial I’m going to give you detailed instructions on how to deploy Telescope on your own server running Centos.

I’m doing this on a  virtual machine on my server, the same procedure applies to any server like Amazon EC2, Heroku or any dedicated server running centos.

At the end of this tutorial you will be running telescope on port 3000 with nginx as proxy.

List of things we will cover in this tutorial

  1. Install node.js
  2. Install mongodb
  3. Install meteor
  4. Install meteorite
  5. Install telescope
  6. Install nginx

Before we start, lets update the system and make sure we have all the development libraries. Run the following commands as root

Installing node.js  and NPM on Centos

Run the following commands. Make takes time, you might wanna get some coffee :)

You don’t have to install NPM sperately, it’s bundled with the node.

If you get “virtual memory exhausted: Cannot allocate memory” error, try rebooting the system.

Note: You might be tempted to get the latest code from git and install it, but for some reason beyond my understanding at this time, it doesn’t work.
It throws some error related to fibers package.
Error: “pre” versions of node cannot be installed, use –nodedir flag instead

Install MongoDB

Create a /etc/yum.repos.d/mongodb.repo file to hold the following configuration information for the MongoDB repository:

If you are running a 64-bit system, use the following configuration:

If you are running a 32-bit system, which is not recommended for production deployments, use the following configuration:

Issue the following command (as root or with sudo) to install the latest stable version of MongoDB and the associated tools:

Install meteor

Installing meteor is very simple, just run the following command

install meteorite

ref: http://docs.meteor.com/

Install Telescope

Last command bundles everything we need to run the app and saves it in your home directory.

Before we run the app, we have to reinstall fibers

Now lets start telescope

PORT=3000 MONGO_URL=mongodb://localhost:27017/myapp_db ROOT_URL=http://myappurl.com/ node bundle/main.js

You can change the port to what ever you want, 80 if you do not want to use a proxy server.

ref: https://github.com/SachaG/Telescope

Using NGINX as proxy for Telescope Meteor app

open nginx configuration file, In Centos it’s located at /etc/nginx/nginx.conf

and add this to server section of the file and restart nginx /etc/init.d/nginx restart

Having to start the Telescope app manually when ever the system reboots is not cool, lets add it to system startup. We will use upstart for this.

Create a file called my_app.conf at /etc/init/ and add the following content to it.

Are all the required programs in startup list? Lets check if mongodb and nginx are in system startup, if not lets add them.

Check it with the following command

sudo /sbin/chkconfig --list

If they are not, add them with the following command

It’s not optimal to serve static files through node, I tried to serve them with nginx but wasn’t successful. I will update the post, once I find the answer.

You should install phantomjs to make your app crawlable/searchable.

Installing Phantomjs

wget https://phantomjs.googlecode.com/files/phantomjs-1.9.2-linux-x86_64.tar.bz2
tar xvf phantomjs-1.9.2-linux-x86_64.tar.bz2
cp phantomjs-1.9.2-linux-x86_64/bin/phantomjs /usr/local/bin

You can get the latest and relevant download links from phantomjs downloads page.
If you face any problems during phatomjs installation, try this tutorial

Though the entire process takes less than 10 minutes now ( excluding the compile time of node ), It took me more than 2 days to figure everything out. I hope this tutorial tutorial saves your time.

If you find all this complicated but want to build a site with telescope, I’m available for hire :). Shouth News is the first site I built with telescope

10 thoughts on “A complete guide to install Meteor App Telescope on Your Own Server”

  1. This is excellent. I have tried to follow your instructions to deploy in a DigitalOcean droplet. However, I don’t seem to be able to start telescope. When I enter into terminal:

    PORT=3000 MONGO_URL=mongodb://localhost:27017/myapp_db ROOT_URL=http://myappurl.com/ node bundle/main.js

    I get:

    module.js:340
    throw err;
    ^
    Error: Cannot find module ‘/Telescope/bundle/main.js’

    Is it because I should replace “myappurl.com/” with my droplet’s ip? Or is there something elee I’m missing?

  2. please help. I have this error. Some blogs say that is because meteor last version don’t support some mongodb confs used in telescope:

    ROOT_URL=http://ec2-54-201-32-51.us-west-2.compute.amazonaws.com node bundle/main.js

    /root/bundle/programs/server/boot.js:185
    }).run();
    ^
    Error: MONGO_URL must be set in environment
    at Object. (packages/mongo-livedata/remote_collection_driver.js:33)
    at Object.defaultRemoteCollectionDriver (packages/underscore/underscore.js:724)
    at new Meteor.Collection (packages/mongo-livedata/collection.js:66)
    at Package (packages/service-configuration/service_configuration_common.js:8)
    at packages/service-configuration.js:43:4
    at packages/service-configuration.js:52:3
    at /root/bundle/programs/server/boot.js:154:10
    at Array.forEach (native)
    at Function._.each._.forEach (/root/bundle/programs/server/node_modules/underscore/underscore.js:79:11)
    at /root/bundle/programs/server/boot.js:81:5

  3. Im facing a problem when I create the telescope folder. When I enter the mrt command, heres what happens….

    Stand back while Meteorite does its thing

    Done installing smart packages

    Ok, everything’s ready. Here comes Meteor!

    iron-router: updating npm dependencies — connect…
    npm ERR! Error: EACCES, open ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’
    npm ERR! { [Error: EACCES, open ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’]
    npm ERR! errno: 3,
    npm ERR! code: ‘EACCES’,
    npm ERR! path: ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’,
    npm ERR! parent: ‘readable-stream’ }
    npm ERR!
    npm ERR! Please try running this command again as root/Administrator.

    npm ERR! System Darwin 13.0.0
    npm ERR! command “/Users/shwaytaj/.meteor/tools/cef2bcd356/bin/node” “/Users/shwaytaj/.meteor/tools/cef2bcd356/bin/npm” “install” “connect@2.9.0″
    npm ERR! cwd /Users/shwaytaj/.meteorite/packages/iron-router/EventedMind/iron-router/05415a8891ea87a00fb1e2388585f2ca5a38e0da/.npm/package-new-123mpg4
    npm ERR! node -v v0.10.29
    npm ERR! npm -v 1.4.14
    npm ERR! path /Users/shwaytaj/.npm/inherits/2.0.1/package/package.json
    npm ERR! code EACCES
    npm ERR! errno 3
    npm ERR! stack Error: EACCES, open ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’
    npm ERR!
    npm ERR! Additional logging details can be found in:
    npm ERR! /Users/shwaytaj/.meteorite/packages/iron-router/EventedMind/iron-router/05415a8891ea87a00fb1e2388585f2ca5a38e0da/.npm/package-new-123mpg4/npm-debug.log
    npm ERR! not ok code 0

    mailchimp: updating npm dependencies — mailchimp…
    npm ERR! Error: EACCES, mkdir ‘/Users/shwaytaj/.npm/request/2.39.0′
    npm ERR! { [Error: EACCES, mkdir ‘/Users/shwaytaj/.npm/request/2.39.0′]
    npm ERR! errno: 3,
    npm ERR! code: ‘EACCES’,
    npm ERR! path: ‘/Users/shwaytaj/.npm/request/2.39.0′,
    npm ERR! parent: ‘mailchimp’ }
    npm ERR!
    npm ERR! Please try running this command again as root/Administrator.

    npm ERR! System Darwin 13.0.0
    npm ERR! command “/Users/shwaytaj/.meteor/tools/cef2bcd356/bin/node” “/Users/shwaytaj/.meteor/tools/cef2bcd356/bin/npm” “install” “mailchimp@1.0.3″
    npm ERR! cwd /Users/shwaytaj/Telescope/packages/mailchimp/.npm/package-new-14y01me
    npm ERR! node -v v0.10.29
    npm ERR! npm -v 1.4.14
    npm ERR! path /Users/shwaytaj/.npm/request/2.39.0
    npm ERR! code EACCES
    npm ERR! errno 3
    npm ERR! stack Error: EACCES, mkdir ‘/Users/shwaytaj/.npm/request/2.39.0′
    npm ERR!
    npm ERR! Additional logging details can be found in:
    npm ERR! /Users/shwaytaj/Telescope/packages/mailchimp/.npm/package-new-14y01me/npm-debug.log
    npm ERR! not ok code 0

    fast-render: updating npm dependencies — connect…
    npm ERR! Error: EACCES, open ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’
    npm ERR! { [Error: EACCES, open ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’]
    npm ERR! errno: 3,
    npm ERR! code: ‘EACCES’,
    npm ERR! path: ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’,
    npm ERR! parent: ‘readable-stream’ }
    npm ERR!
    npm ERR! Please try running this command again as root/Administrator.

    npm ERR! System Darwin 13.0.0
    npm ERR! command “/Users/shwaytaj/.meteor/tools/cef2bcd356/bin/node” “/Users/shwaytaj/.meteor/tools/cef2bcd356/bin/npm” “install” “connect@2.13.0″
    npm ERR! cwd /Users/shwaytaj/.meteorite/packages/fast-render/arunoda/meteor-fast-render/149984b1aff3a5642a270aff9bd9006872c8302e/.npm/package-new-tbpvw
    npm ERR! node -v v0.10.29
    npm ERR! npm -v 1.4.14
    npm ERR! path /Users/shwaytaj/.npm/inherits/2.0.1/package/package.json
    npm ERR! code EACCES
    npm ERR! errno 3
    npm ERR! stack Error: EACCES, open ‘/Users/shwaytaj/.npm/inherits/2.0.1/package/package.json’
    npm ERR!
    npm ERR! Additional logging details can be found in:
    npm ERR! /Users/shwaytaj/.meteorite/packages/fast-render/arunoda/meteor-fast-render/149984b1aff3a5642a270aff9bd9006872c8302e/.npm/package-new-tbpvw/npm-debug.log
    npm ERR! not ok code 0

    Errors prevented bundling:
    While building package iron-router:
    error: couldn’t install npm package

    While building package mailchimp:
    error: couldn’t install npm package

    While building package fast-render:
    error: couldn’t install npm package

    /usr/local/lib/node_modules/meteorite/lib/command.js:41
    throw “Command exited with ” + code + “/” + signal;
    ^
    Command exited with 1/null
    static-7:telescope shwaytaj$

    1. Having a similar problem (i believe).

      I followed the instructions no problem until I get to the part of “cd ~/bundle/programs/server” where I get the no such file or directory error. I tried looking for the “bundle/main.js” no such file. I’VE BEEN ON THIS FOR ALMOST A MONTH. Please HELP?

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code class="" title="" data-url=""> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> <pre class="" title="" data-url=""> <span class="" title="" data-url="">