gancio-upstream/docs/configuration.md

layout	title	permalink	nav_order
default	Configuration	/config	3

Configuration

{: .no_toc } Main gancio configuration is done with a configuration file. This shoud be a .json or a .js file and could be specified using the --config flag.

• eg. gancio start --config ./config.json
• eg. pm2 start gancio start -- --config ~/config.json

1. TOC {:toc}

• Title

The title will be in rss feed, in html head and in emails:

"title": "Gancio"

• Description

"description": "a shared agenda for local communities"

• BaseURL

URL where your site will be accessible (include http or https):
"baseurl": "https://gancio.cisti.org"

• Server

This probably support unix socket too :D

"server": {
    "host": "localhost",
    "port": 13120
}

• Database

DB configuration, look here for options.

  "db": {
    "dialect": "sqlite",
    "storage": "/tmp/db.sqlite"
  }

• Upload path

Where to save images "upload_path": "./uploads"

• SMTP

• Admin

Email of administrator. Email from gancio comes from this email.

• Favicon

You could specify another favicon. This is also used as logo (top-left corner):
"favicon": "./favicon.ico"

• User locale

Probably you want to modify some text for your specific community, that's why we thought the user_locale configuration: you can specify your version of each string of gancio making a directory with your locales inside. For example, let's say you want to modify the text inside the /about page:
mkdir /opt/gancio/user_locale put something like this in /opt/gancio/user_locale/en.js to override the about in english:

export default {
      about: 'A new about'
}

and then point the user_locale configuration to that directory:

"user_locale": "/opt/gancio/user_locale"

Watch here for a list of strings you can override.
⚠️ Note that a restart is needed when you change user_locale's content.

• Secret

Default settings

{
  "title": "Gancio",
  "description": "A shared agenda for local communities",
  "baseurl": "http://localhost:13120",
  "server": {
    "host": "0.0.0.0",
    "port": 13120
  },
  "db": {
    "dialect": "sqlite",
    "storage": "/tmp/db.sqlite"
  },
  "upload_path": "./",
  "favicon": "../dist/favicon.ico",
  "smtp": {
    "auth": {
      "user": "",
      "pass": ""
    },
    "secure": true,
    "host": ""
  },
  "admin_email": "",
  "secret": "notsosecret"
}