mirror of
https://github.com/n8n-io/n8n.git
synced 2024-11-09 22:24:05 -08:00
Add information about how to use MongoDB as database
This commit is contained in:
parent
1c956f326f
commit
28262fdb79
|
@ -12,7 +12,7 @@ is there currently not much documentation. That will hopefully change soon.
|
||||||
|
|
||||||
To simply spin up n8n to have a look and give it spin you can simply run:
|
To simply spin up n8n to have a look and give it spin you can simply run:
|
||||||
|
|
||||||
```
|
```bash
|
||||||
npx n8n
|
npx n8n
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -26,16 +26,63 @@ You can then access n8n by opening:
|
||||||
|
|
||||||
To fully install n8n globally execute:
|
To fully install n8n globally execute:
|
||||||
|
|
||||||
```
|
```bash
|
||||||
npm install n8n -g
|
npm install n8n -g
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Start
|
||||||
|
|
||||||
After the installation n8n can be started by simply typing in:
|
After the installation n8n can be started by simply typing in:
|
||||||
```
|
|
||||||
|
```bash
|
||||||
n8n
|
n8n
|
||||||
|
# or
|
||||||
|
n8n start
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### Start with tunnel
|
||||||
|
|
||||||
|
To be able to use webhooks which all triggers of external services like Github
|
||||||
|
rely on n8n has to be reachable from the web. To make that easy n8n has a
|
||||||
|
special tunnel service which redirects requests from our servers to your local
|
||||||
|
n8n instance.
|
||||||
|
|
||||||
|
To use it simply start n8n with `--tunnel`
|
||||||
|
|
||||||
|
```bash
|
||||||
|
n8n start --tunnel
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### Start with MongoDB as Database
|
||||||
|
|
||||||
|
By default n8n uses SQLite to save credentials, past executions and workflows.
|
||||||
|
To use MongoDB instead you can either overwrite the default configuration on
|
||||||
|
startup like this:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
n8n start \
|
||||||
|
--NODE_CONFIG='{\"database\":{\"type\":\"mongodb\", \"mongodbConfig\":{\"url\":\"mongodb://MONGO_USER:MONGO_PASSWORD@MONGO_SERVER:MONGO_PORT/MONGO_DATABASE\"}}}'"
|
||||||
|
```
|
||||||
|
|
||||||
|
Or you can provide a custom configuration file by copying the default
|
||||||
|
configuration file [(config/defaults.ts)](config/default.ts) and then set the
|
||||||
|
path to it as environment variable `NODE_CONFIG_DIR`.
|
||||||
|
|
||||||
|
For example like this:
|
||||||
|
```bash
|
||||||
|
export NODE_CONFIG_DIR=/path-to-my-config
|
||||||
|
```
|
||||||
|
|
||||||
|
In the file change then the
|
||||||
|
setting under `database.type` from `sqlite` to `mongodb` and adjust the Mongo
|
||||||
|
connection URL `database.mongodbConfig` accordingly.
|
||||||
|
|
||||||
|
|
||||||
|
n8n will then read your custom configuration and use MongoDB instead.
|
||||||
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
[Apache 2.0 with Commons Clause](LICENSE.md)
|
[Apache 2.0 with Commons Clause](LICENSE.md)
|
||||||
|
|
Loading…
Reference in a new issue