Installing An App - Production

To install an app in production mode, you must install an app using the app id.

Quick Instructions

Below is a simple reminder for those who just need a quick reminder of the steps of installing an app for production. If you need more explanation of each step, see the detailed instructions below.

  1. In your api-dir run fw install [appid]

  2. Setup in Group Control

    • In Apps => add department to app (ie administrator).

    • In Users/Groups => Give access to your app.

  3. Go to app in browser

Detailed Instructions

Below are more detailed instructions with further explanation for each step.

  1. In a terminal/command prompt, navigate to your FW installation
C:\Users\[yourUserName]> cd webroot
C:\Users\[yourUserName]\webroot\fw-dev> cd fw-dev
C:\Users\[yourUserName]\webroot\fw-dev>

  1. Navigate to the repository of the app you wish to install, to find the app id.

    • Navigate to "Source", then client/package.json, and find the value of app id.

  2. In the terminal run fw install [appid]. In the rest of this example, sta will be the assumed app you are using (you will substitute your app id).

C:\Users\[yourUserName]\webroot\fw-dev> fw install sta
  1. Hit enter for all the options.
Downloading Status v0.4.19: Complete!

Web Root [./public]:
>

App Url [/sta/]:
>

Moving public files: Complete!
Installing addon 'migration-core': Complete!
Installing addon 'mail-core': Complete!

Do you want to set up config values for all apps? (yes/no) [yes]:
>

The section 'database' is already defined in your config. Do you want to re-configure it? (yes/no) [no]:
>

[OK] App 'sta' installed

C:\Users\[yourUserName]\webroot\fw-dev>

  1. Configure the app in group control: Group Control Configuration Tutorial

  2. Navigate to where your app is outputting. App url can be determined by looking at (in default setup):

  • The servername property can be found in the vhosts apache configuration file, which can be found in the apache configuration of your web server:
    • if using Xampp: C:/xampp/apache/conf/extra/httpd-vhosts.conf
    • if using Wamp: C:\wamp\bin\apache\Apache2.2.21\conf\extra\httpd-vhosts.conf
    • For example: "fw.localhost.com"
  • The outputDirectory property in the api-dir/apps/my-app/config.json file
    • For example: ../../public/sta in this example
  • Append serverName with everything after 'public' in the outputDirectory. So in this example, you would navigate to fw.localhost.com/sta.