Farmbot-Web-App/DEPLOYMENT.md

Deployment

0. Create a fresh Ubuntu 16 server with Dokku (or just use DigitalOcean)

• Make sure you have atleast 1gb.

0. Install the latest version of Dokku (don't use that DigitalOcean image)
1. Setup Dokku by visiting the server's URL. Follow the directions on screen.
2. git remote add my_server dokku@your-server:my-api-name
3. Install mariaDB plugin: instructions.
4. Create a databse: ssh dokku@your-server mariadb:create my_db
5. Link the DB: ssh dokku@your-server mariadb:link my_db my-api-name
6. Set ENV vars:

• ssh dokku@your-server config:set my-api-name DEVISE_SECRET=$(rake secret)
• ssh dokku@your-server config:set my-api-name JS_FILE_URL=//mycdn.org/farmbot-fronted.js
• ssh dokku@your-server config:set my-api-name MQTT_HOST=my-mqtt-server.org
• ssh dokku@your-server config:set my-api-name DATABASE_URL=mysql://dbusername:dbpassword@dburl:dbport/dbname

0. Migrate / create db: ssh dokku@your-server run my-api-name rake db:setup
1. Give Dokku a place to store RSA keys: ssh dokku@your-server storage:mount my-api-name /var/lib/dokku/data/keys:/keys.

• If you don't do this (or don't want to) you will need to restart your MQTT server and re-run setup.rb after any deployments / upgrades.

0. Generate Encryption keys ssh dokku@your-server run my-api-name rake keys:generate

Old / Legacy Setup

(Added Sept. 2016)

No longer used, but possibly relevant for those running legacy servers.

0. Create a fresh Ubuntu 14 server with Dokku (or just use DigitalOcean)
1. Upgrade to the latest version of Dokku (especially if you are on DigitalOcean- their version is out of date)
2. Install dokku-haproxy plugin: ssh root@YOUR_SERVER dokku plugin:install https://github.com/256dpi/dokku-haproxy.git
3. Deploy: git push dokku@YOUR_SERVER:mqtt
4. Point to correct host/port: ssh dokku@MQTT_SERVER config:set mqtt PORT=3002 DOKKU_NGINX_PORT=3002 WEB_APP_URL=WEBAPP_URL_HERE
5. Expose MQTT port: ssh dokku@MQTT_SERVER ports:add mqtt 1883 web 1883