The Box

Development setup

sudo adduser yellowtent ** This dummy user is required for supervisor 'box' configs
rmappdir.sh should be callable without a password ** Add a file called /etc/sudoers.d/yellowtent with the following contents: Defaults!/home/girish/yellowtent/box/src/rmappdir.sh env_keep=HOME girish ALL = (ALL) NOPASSWD: /home/girish/yellowtent/box/src/rmappdir.sh Defaults!/home/girish/yellowtent/box/src/reloadnginx.sh env_keep=HOME girish ALL = (ALL) NOPASSWD: /home/girish/yellowtent/box/src/reloadnginx.sh

(replace the username and path to rmappdir.sh to match your environment)

You might have to clear the sudo cache using sudo -k.

** Verify using sudo src/rmappdir.sh --check. This should print 'OK' ** Verify using sudo src/reloadnginx.sh --check. This should print 'OK'

Set your hostname to 'mybox.cloudron.us' ** On Mac, settings the hostname through command line resets the name periodically. Using the network control panel, always appends a .local suffix. Workaround: sudo scutil --set HostName mybox.cloudron.us
export FQDN='mybox.cloudron.us' (add this to your .bashrc) ** Add the above domain to your /etc/hosts ** All apps will be installed as hypened-subdomains of the above FQDN ** You should add hyphened-subdomains of your apps into /etc/hosts

./run.sh - this starts up nginx to serve up the webadmin ** https://mybox.cloudron.us should now be accessible ** Do not use https://localhost. It will appear to work work but will break oauth redirection
DEBUG=box:* ./app.js - this the main box code ** NODE_ENV is set to production by default

Creating a box image involves the following steps:

Start a vanilla Ubuntu DO
scripts/createBaseUbuntuImage.sh <DROPLET_IP>
Snapshot the image in DO
Change heroku config to that image id above
- curl "https://api.digitalocean.com/v1/images/?client_id=f18dbe3b7090fa0a3f6878709dd555aa&api_key=ee47d2d5b2f2a4281508e3a962c488fc" | python -m json.too
- heroku config:set DIGITAL_OCEAN_IMAGE=5561068