Skip to content

Prepare

Gmail credentials and service account files

The app sends emails from a Gmail account and monitors replies for commands. gmail_credentials.json is required for Google sign-in. service_account.json lets the app manage Google Pub/Sub resources without requiring the Gmail user to have project Editor permissions. Generate these files if you do not have them.

  • gmail_credentials.json
  • service_account.json

Create the directory below and place gmail_credentials.json in it before starting the app. Add service_account.json if you use a service account for Pub/Sub.

  1. Create the necessary directories on the new machine.
# Run from the directory containing docker-compose-released.yml
mkdir -p gmail

Use BrainFrame CLI to find out your {install_path}:

brainframe info install_path
  1. Copy gmail_credentials.json and, if applicable, service_account.json into the gmail subdirectory you just created. The final paths on your server are {install_path}/gmail/gmail_credentials.json and {install_path}/gmail/service_account.json.

You can use tools like scp or rsync to copy the files from your local machine to the new server. For example:

# Example using scp from your local machine
scp /path/to/your/local/gmail_credentials.json user@<NEW_MACHINE_IP>:{install_path}/gmail/
scp /path/to/your/local/service_account.json user@<NEW_MACHINE_IP>:{install_path}/gmail/

Have user email addresses ready

  • Notification email addresses (for storage and post-incident investigation)
  • Human-in-the-loop email addresses (for real-time response)
  • Report email addresses (for management)