2017-02-21 13:27:41 -07:00
|
|
|
# ░██████░░███████░░█████░░░██████░░
|
2018-05-30 14:15:44 -06:00
|
|
|
# ░██░░░░░░░░██░░░░██░░░██░░██░░░██░ READ EVERYTHING BEFORE USING.
|
2018-10-01 15:04:44 -06:00
|
|
|
# ░██████░░░░██░░░░██░░░██░░██████░░ SEE NOTES BELOW
|
2017-02-21 13:27:41 -07:00
|
|
|
# ░░░░░██░░░░██░░░░██░░░██░░██░░░░░░
|
|
|
|
# ░██████░░░░██░░░░░████░░░░██░░░░░░
|
|
|
|
# You will hit issues if any of these are set to the wrong value.
|
|
|
|
# Please read each line of this file before starting the server.
|
2017-05-04 06:39:12 -06:00
|
|
|
#
|
2017-06-30 08:09:27 -06:00
|
|
|
# PLEASE READ ALL ENTRIES.
|
|
|
|
# =============================================================================
|
2017-02-21 13:27:41 -07:00
|
|
|
#
|
|
|
|
# Self hosting users can safely delete this (a new key will be created).
|
|
|
|
# This key is used to exchange secrets between bots and MQTT servers (important
|
|
|
|
# if you don't use SSL)
|
2017-05-18 07:18:58 -06:00
|
|
|
# SERVER WONT WORK IF YOU FORGET TO DELETE THIS EXAMPLE TEXT BELOW.
|
|
|
|
# ADD A REAL RSA_KEY OR DELETE THIS LINE!!
|
2018-10-01 15:04:44 -06:00
|
|
|
RSA_KEY="Change this! Keys look like `-----BEGIN RSA .........`"
|
|
|
|
# If your server is on a domain (eg=my-own-farmbot.com), put it here.
|
2018-02-26 08:13:54 -07:00
|
|
|
# DONT USE `localhost`.
|
|
|
|
# DONT USE `127.0.0.1`.
|
|
|
|
# DONT USE `0.0.0.0`.
|
|
|
|
# Use a real ip or domain name.
|
2018-10-01 15:04:44 -06:00
|
|
|
API_HOST="12.34.56.78"
|
2017-02-21 13:27:41 -07:00
|
|
|
# 3000 for local development. 443 is using SSL. You will need `sudo` to use PORT
|
|
|
|
# 80 on most systems.
|
2018-10-01 15:04:44 -06:00
|
|
|
API_PORT="3000"
|
2017-05-18 07:18:58 -06:00
|
|
|
# This can be set to anything.
|
|
|
|
# Most users can just delete it.
|
|
|
|
# This is used for people writing modifications to the software, mostly.
|
2018-10-01 15:04:44 -06:00
|
|
|
DOCS="Set this to any value if you want to generate API docs after running tests"
|
2017-05-18 07:18:58 -06:00
|
|
|
# Used by people who pay for managed database hosting.
|
2018-10-01 17:46:42 -06:00
|
|
|
# Most users can delete this.
|
2018-10-01 15:04:44 -06:00
|
|
|
DATABASE_URL="postgres://USERNAME:PASSWORD@URL:PORT/DB_NAME"
|
2018-10-01 17:46:42 -06:00
|
|
|
# MUST REPLACE. MUST BE A VERY RANDOM VALUE.
|
|
|
|
# 128 CHARACTERS LONG, HEXADECIMAL STRING (0-9, A-F)
|
|
|
|
DEVISE_SECRET="Used for devise. Generate a new value using `openssl rand -hex 64`."
|
2017-02-21 13:27:41 -07:00
|
|
|
# Most personal server users can delete this.
|
2018-10-01 15:04:44 -06:00
|
|
|
FORCE_SSL="Remove this if not using HTTPS://"
|
2017-10-11 09:32:49 -06:00
|
|
|
# FarmBot OS update server. Use default if you don't have a special use case.
|
2017-02-21 13:27:41 -07:00
|
|
|
# Off grid servers may have issues connecting to our update URL.
|
2018-10-01 15:04:44 -06:00
|
|
|
OS_UPDATE_SERVER="https://api.github.com/repos/farmbot/farmbot_os/releases/latest"
|
2017-05-18 07:18:58 -06:00
|
|
|
# Google Cloud Storage API Bucket for image data.
|
|
|
|
# Deleting this will save to disk.
|
|
|
|
# Most self hosting users will want to delete this.
|
2018-10-01 15:04:44 -06:00
|
|
|
GCS_BUCKET="GOOGLE_CLOUD_STORAGE_BUCKET_NAME_FOR_IMAGE_FILES"
|
2017-05-18 07:18:58 -06:00
|
|
|
# Google Cloud Storage ID for image data.
|
|
|
|
# Deleting this will save images to disk.
|
|
|
|
# Most self hosting users will want to delete this.
|
2018-10-01 15:04:44 -06:00
|
|
|
GCS_ID="GOOGLE_CLOUD_STORAGE='interop' id"
|
2017-05-18 07:18:58 -06:00
|
|
|
# Most self hosting users will want to delete this.
|
2018-10-01 15:04:44 -06:00
|
|
|
GCS_KEY="GOOGLE_CLOUD_STORAGE='interop' key"
|
2017-05-18 07:18:58 -06:00
|
|
|
# Most self hosting users will want to delete this.
|
2018-10-01 15:04:44 -06:00
|
|
|
HEROKU_SLUG_COMMIT="This is set by Heroku, used by Frontend to show current version."
|
2018-10-01 17:46:42 -06:00
|
|
|
# Where is your MQTT server running? 99% of setups will use the same value
|
|
|
|
# found in API_HOST. Heroku users will not use the same value.
|
2017-05-18 07:18:58 -06:00
|
|
|
# Use a REAL IP ADDRESS if you are controlling real bots.
|
2018-10-01 15:04:44 -06:00
|
|
|
MQTT_HOST="98.76.54.32"
|
2017-02-21 13:27:41 -07:00
|
|
|
# Same as above. Can be deleted unless you are a Rollbar.IO customer.
|
2018-10-01 15:04:44 -06:00
|
|
|
ROLLBAR_ACCESS_TOKEN="____"
|
|
|
|
ROLLBAR_CLIENT_TOKEN="____"
|
2017-05-18 07:18:58 -06:00
|
|
|
# FarmBot, Inc. uses SendGrid to send emails.
|
|
|
|
# Delete these if you don't use send grid.
|
2018-10-01 15:04:44 -06:00
|
|
|
SENDGRID_PASSWORD="Used by FarmBot, Inc"
|
|
|
|
SENDGRID_USERNAME="Used by FarmBot, Inc"
|
2017-05-18 07:18:58 -06:00
|
|
|
# For email delivery. Who is your email host?
|
2018-10-01 15:04:44 -06:00
|
|
|
SMTP_HOST="smtp.sendgrid.net"
|
2017-02-10 06:58:52 -07:00
|
|
|
# Optional with default of 587
|
2018-10-01 15:04:44 -06:00
|
|
|
SMTP_PORT="587"
|
2017-05-04 06:39:12 -06:00
|
|
|
# Set this if you don't want to deal with email verification of new users.
|
2017-05-18 07:18:58 -06:00
|
|
|
# (self hosted users)
|
2018-10-01 15:04:44 -06:00
|
|
|
NO_EMAILS="TRUE"
|
2017-10-05 15:42:46 -06:00
|
|
|
# Self hosting users can delete this line.
|
2018-10-01 15:04:44 -06:00
|
|
|
# If you are not using the standard MQTT broker (eg=you use a 3rd party
|
2017-10-05 15:42:46 -06:00
|
|
|
# MQTT vendor), you will need to change this line.
|
2018-10-01 15:04:44 -06:00
|
|
|
MQTT_WS="ws://DELETE_OR_CHANGE_THIS_LINE/ws"
|
2017-10-11 15:25:50 -06:00
|
|
|
# If you are using a shared RabbitMQ server and need to use a VHost other than
|
|
|
|
# "/", change this ENV var.
|
2018-10-01 15:04:44 -06:00
|
|
|
MQTT_VHOST="/"
|
|
|
|
# If you run a server with multiple domain names (HINT=You probably don't),
|
2018-01-13 09:39:43 -07:00
|
|
|
# you can list the names here. This is used by FarmBot employees so that they
|
|
|
|
# can securly host the same server on multiple domain names
|
2018-10-01 15:04:44 -06:00
|
|
|
# ex=my.farm.bot, my.farmbot.io
|
|
|
|
EXTRA_DOMAINS=staging.farm.bot,whatever.farm.bot
|
2018-02-25 10:59:28 -07:00
|
|
|
# If you are a software developer and you wish to run integration tests, set the
|
|
|
|
# ENV below to "true".
|
|
|
|
# Most users will not want this enabled.
|
2018-10-01 15:04:44 -06:00
|
|
|
RUN_CAPYBARA="true"
|
2018-03-07 12:36:01 -07:00
|
|
|
# Set this to "production" in most cases.
|
2018-08-24 14:21:16 -06:00
|
|
|
# Setting this line to "production" will disable debug backtraces.
|
|
|
|
# Please delete this line if you are submitting a bug report on the forum/Github
|
2018-10-01 15:04:44 -06:00
|
|
|
RAILS_ENV="production"
|
2018-06-21 09:27:24 -06:00
|
|
|
# Every server has a superuser.
|
|
|
|
# Set this to something SECURE.
|
2018-10-01 15:04:44 -06:00
|
|
|
ADMIN_PASSWORD=""
|
|
|
|
# Some hosts (Eg=FarmBot, Inc.) run the RabbitMQ management API on a
|
2018-07-05 15:06:59 -06:00
|
|
|
# non-standard host.
|
|
|
|
# Include the protocol! (http vs. https)
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
RABBIT_MGMT_URL="http://delete_this_line.com"
|
2018-08-16 12:16:03 -06:00
|
|
|
# Allow only certain users on the server. If the user's email domain is not
|
|
|
|
# on the list of trusted domains, they can not use the server.
|
|
|
|
# The example below only allows users with `@farmbot.io` or `@farm.bot` emails
|
|
|
|
# to use the server.
|
|
|
|
# DELETE THIS LINE IF YOU RUN A PUBLIC SERVER.
|
2018-10-01 15:04:44 -06:00
|
|
|
TRUSTED_DOMAINS="farmbot.io,farm.bot"
|
2018-09-20 09:03:14 -06:00
|
|
|
# Nerves Hub Configuration
|
|
|
|
# Nerves Hub handles OTA Firmware updates.
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_HOST="delete_this.org"
|
2018-09-20 09:03:14 -06:00
|
|
|
# Port to connect to.
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_PORT=443
|
2018-09-20 09:03:14 -06:00
|
|
|
# Organization that the cert and key are authorized to access.
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_ORG="delete_this_line"
|
2018-09-20 09:03:14 -06:00
|
|
|
# Where to temporarily store device cert sign requests
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_DEVICE_CSR_DIR="/delete/this/path"
|
2018-09-20 09:03:14 -06:00
|
|
|
# Contents of the NervesHub authorized cert
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_CERT="Change this! Cert looks like `-----BEGIN CERTIFICATE-----`"
|
2018-09-20 09:03:14 -06:00
|
|
|
# Contents of the NervesHub authorized key
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_KEY= "Change this! Key looks like `-----BEGIN EC PRIVATE KEY-----`"
|
2018-09-20 09:03:14 -06:00
|
|
|
# Contents of the NervesHub cert chain. Should contain one root-ca,
|
|
|
|
# and 3 intermediates.
|
|
|
|
# DELETE THIS LINE if you are a self-hosted user.
|
2018-10-01 15:04:44 -06:00
|
|
|
NERVES_HUB_CA= "Change this! CA looks like `-----BEGIN CERTIFICATE-----`"
|