Configuration

gancio configuration is done during installation process but you can change it editing the configuration file. The configuration file 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. Server
2. Database
3. Upload path
4. Plugins path
5. User locale
6. Proxy

Server

This probably support unix socket too

"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"

Plugins path

Where to search for plugins
"plugins_path": "./plugins"

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 shown during registration:
mkdir /opt/gancio/user_locale

put something like this in /opt/gancio/user_locale/en.json to override the registration description in english:

{
  "register": {
    "description": "My new registration page description"
  }
}

and then point the user_locale configuration to that directory (in your config.json):

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

Watch here for a list of strings you can override.

Restart needed

Note that a restart is needed when you change user_locale’s content.

Proxy

Proxy outward request from gancio. Look here for options. Note: hostname option takes precedence over host.

"proxy": {
    "protocol": "http:",
    "hostname": "",
    "host": "127.0.0.1",
    "port": "8118",
    "auth": {
      "username": "user",
      "password": "password"
    },
    "headers": {
      "X-Proxy-Header": "example"
    }
}