Advanced configuration options
Some configuration options can not be edited through the UI and should only be used if needed.
Depending on the option they can be configured either by editing the config.yml
configuration file or by using an enviroment variable or in a few cases by using flags when running stash.
As an example the port
option can be changed from the default 9999
to 1234
by one of the below methods:
- adding
port: 1234
to the config.yml file - setting the ENV variable STASH_PORT to 1234 eg
STASH_PORT=1234 ./stash
- using the flag --port when running stash
./stash --port 1234
Configuration Option | YML | ENV | FLAG | Description | Comments |
---|---|---|---|---|---|
host | host | STASH_HOST | --host | The ip address for the host that stash is listening to | default: 0.0.0.0 |
port | port | STASH_PORT | --port | The port that stash serves to | default: 9999 |
external host | external_host | STASH_EXTERNAL_HOST | - | Needed in some cases when you use a reverse proxy | Docs |
plugins path | plugins_path | - | - | The path to the stash plugins folder | Only use if you need to override the default |
scrapers path | scrapers_path | - | - | The path to the scrapers folder | Only use if you need to override the default |
custom served folders | custom_served_folders | - | - | Allows configuration of mapped URLs to file system folders | PR |
maximum upload size | max_upload_size | - | - | Change the maximum size (in MB) for partial imports | default: 1024 (1GB) |
proxy | proxy | - | - | The url of a HTTP(S) proxy to be used when stash makes calls to online services | Example: https://user:password@my.proxy:8080 |
no proxy | no_proxy | - | - | A list of domains for which the proxy must not be used | default is all local LAN: localhost,127.0.0.1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12 |