Basic Walkthrough


This guide demonstrates how to get a simple project up and running on FaktorZ.

The following sections guide you through creating a project that contains a sample Node.js application that will serve a welcome page and the current hit count (stored in a database) using the FaktorZ web console. This involves creating two pods:

  • one to host the Node.js application

  • one to host the MongoDB database

The tutorial assumes you have:

  • an FaktorZ account.

  • a GitHub account.

  • Git installed locally.


In this section, you will fork the FaktorZ Node.js sample application on GitHub and clone the repository to your local machine so that you can deploy and edit the application.

  1. On GitHub, navigate to the thedigitalgarage/nodejs-ex repository. In the top-right corner of the page, click Fork:

    Fork the project
  2. Next, execute the following commands on your local machine to clone the sample application and change to the new directory:

    $ git clone<your_github_username>/nodejs-ex
    $ cd nodejs-ex

That’s it! Now, you have a fork of the original thedigitalgarage/nodejs-ex example application Git repository and a copy on your local machine.

Get Oriented with the Web Console

Visit the Web Console topic to learn about its components.

Creating a New Application

In this section, you will deploy your first application to FaktorZ using the web console.

  1. Navigate to the welcome page of the FaktorZ web console. If you have not created a project, you will see a welcome message from with instructions to "open your account settings" and create a new project. You can click the link provided in the message or choose the drop down menu for your profile in the upper right corner of the screen. In the dropdown menu choose Account to be directed to your account dashboard.

    Welcome to
  2. In your account dashboard, click the Create a Project button to configure the settings for your project. In the New Subscription screen replace my-project with a unique and lasting name for your project, such as <your_github_username>-<application>. This namespace can be used for many projects in many stages over coming months. It is best to think of the project as a long-lived workspace rather than a temporary project. You can leave the description blank if you like. With the slider, choose the resources you would like to assign to this workspace/project.

    Account Dashboard

    You will be able to change the resources assigned to this workspace at any time by upgrading or downgrading your resource plan.

    Click the GO/CODE button.

    New projects

    If you have not entered your payment information for the account, you will see a pop-up payments screen. On this screen you will have the option of entering a discount code for a free subscription or discounts off of our standard plans.

  3. After you have created your project, go back to the web console page by closing the account tab or window. You will now see the project you just created in your project list.