Skip to content

Install on Windows

Jump to bottom
Kun Yang edited this page Sep 20, 2017 · 3 revisions

Install mCard on a Windows computer is easy.

  1. Install MySQL (https://dev.mysql.com/downloads/installer/)
  2. Install Bitnami Ruby Stack (https://bitnami.com/stack/ruby/installer). Learn more about Bitnami Ruby Stack: https://docs.bitnami.com/installer/infrastructure/ruby/#step-3-deploy-your-rails-application
  3. Start Bitnami Ruby Stack via "Start -> Bitnami APPNAME Stack -> Application console"
  4. Download mCard from Github: https://github.com/KunYang99/mCard
  5. Create MySQL database and load default data (e.g. C:/Bitnami/rubystack-2.0.0-23/projects/mCard/dumps/seed.sql) You can use MySQL Workbench, phpMyAdmin, or command line to create MySQL databases
  6. In Bitnami Ruby Stack console, go to the folder you just downloaded, for example cd C:/Bitnami/rubystack-2.0.0-23/projects/mCard

Below steps are the same as installing on a Mac or Linux computer. Watch how to install mCard on a Mac or Linux computer from Youtube: https://youtu.be/RvSlEvd2HqE

  1. In the console, run bundle install
  2. create config/database.yml to link mCard to MySQL database. An example of database.yml
  development:
     adapter: mysql2
     encoding: utf8
     reconnect: false
     database: mcard_dev
     pool: 5
     username: root
     password: root
     hostname: localhost
     socket: /tmp/mysql.sock
  1. In the console, run rails s puma
  2. Congrats, your own mCard system is online: http://localhost:3000. You will see a page like this:
  3. The default username and password for administrator is root:root. You can change the password via "Manage Your Account" or "Administration Portal".
  4. Now you are ready to use mCard to manage your own data.

Important

If it is the first time that you install mCard on the computer or the address of mCard is changed, you need to update reCAPTCHA settings. To set up reCAPTCHA:

  • Go to: https://www.google.com/recaptcha/admin#list

  • Register new site follow instructions on the page. When choosing the type of reCAPTCHA, select reCAPTCHA V2 (validate users with the "I am not a robot" checkbox)

  • After registration, you will get the new key and secret

  • Update environment variables. Add or update the following two lines in ~/.bashrc:

    export reCAPTCHA_key="YOUR_KEY"

export reCAPTCHA_secret="YOUR_SECRET"

  • reload configuration: source ~/.bashrc

  • start or restart mCard

Learn how to set up reCAPTCHA from YouTube: How to set up reCAPTCHA for mCard

Clone this wiki locally