mirror of
https://github.com/SunRed/haste-server.git
synced 2024-11-23 17:50:19 +01:00
7d476a668e
This is experimental as there are couple issues with attemting to set duplicate keys and connecting on startup, but it's working regardless of those issues.\nMaybe I can look into solving those later if needed
144 lines
3.5 KiB
Markdown
144 lines
3.5 KiB
Markdown
# Storage
|
|
|
|
Here's a list of all supported document store systems.
|
|
One of these is meant to be set in `config.json` as `storage` object.
|
|
Default type is [file](#file) with save directory at `./data`.
|
|
With some storage options you can set up document expiration - after which documents will no longer be available
|
|
|
|
**Table of Contents**
|
|
|
|
In alphabetical order:
|
|
|
|
- [Amazon S3](#amazon-s3)
|
|
- [File](#file)
|
|
- [Memcached](#memcached)
|
|
- [MongoDB](#mongodb)
|
|
- [Postgres](#postgres)
|
|
- [Redis](#redis)
|
|
- [RethinkDB](#rethinkdb)
|
|
|
|
|
|
## Amazon S3
|
|
|
|
Not rewritten yet, to be filled in
|
|
|
|
|
|
## File
|
|
|
|
Default storage option, with no further installation required.
|
|
Stores documents in a specified directory in files named with a md5 hash of the key to avoid any security issues.
|
|
Default path is `./data`
|
|
> **NOTE:** File storage option does not support document expiration!
|
|
|
|
Config:
|
|
|
|
```json
|
|
{
|
|
"type": "file",
|
|
"path": "./data"
|
|
}
|
|
```
|
|
|
|
|
|
## Memcached
|
|
|
|
Not rewritten yet, to be filled in
|
|
|
|
|
|
## MongoDB
|
|
|
|
Requires npm package (Tested on v3.6.0):
|
|
|
|
```bash
|
|
npm i mongodb
|
|
```
|
|
|
|
Stores documents in a specified database in a collection named `entries`.
|
|
Expiration property in config can be changed to a value in seconds after which entries will not be served.
|
|
|
|
Optimal default config:
|
|
> **NOTE:** Depending on how your MongoDB server is configured, options as connectionUri may vary.
|
|
If server has no authentication, you can omit the `auth` object.
|
|
|
|
Check [documentation](https://mongodb.github.io/node-mongodb-native/3.5/api/MongoClient.html) for more detailed explanation about available `clientOptions` properties.
|
|
|
|
```json
|
|
{
|
|
"type": "mongodb",
|
|
"expire": 0,
|
|
"connectionUri": "mongodb://localhost:27017/haste",
|
|
"clientOptions": {
|
|
"useUnifiedTopology": true,
|
|
"useNewUrlParser": true,
|
|
"keepAlive": true,
|
|
"keepAliveInitialDelay": 60000,
|
|
"poolSize": 30,
|
|
"socketTimeoutMS": 360000,
|
|
"connectTimeoutMS": 360000,
|
|
"auth": {
|
|
"user": "username",
|
|
"password": "password"
|
|
},
|
|
"authSource": "admin"
|
|
}
|
|
}
|
|
```
|
|
|
|
|
|
## Postgres
|
|
|
|
Requires npm package (Tested on v8.3.3):
|
|
|
|
```bash
|
|
npm install pg
|
|
```
|
|
|
|
You will have to create the database and add a table named `entries`. It can be easily done with the following query:
|
|
|
|
`CREATE TABLE entries (id SERIAL PRIMARY KEY, key VARCHAR(255) NOT NULL, value TEXT NOT NULL, expiration INT, UNIQUE(key));`
|
|
|
|
Properties in `clientOptions` are optimal defaults and should be sufficient to run haste, however more detailed explanation for them can be found in pg package [documentation](https://node-postgres.com/api/client).
|
|
Expiration property in config can be changed to a value in seconds after which entries will not be served.
|
|
|
|
```json
|
|
{
|
|
"type": "postgres",
|
|
"expire": 0,
|
|
"clientOptions": {
|
|
"host": "localhost",
|
|
"port": 5432,
|
|
"user": "username",
|
|
"password": "password",
|
|
"database": "haste"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Redis
|
|
|
|
Requires npm package (Tested on v4.17.3):
|
|
|
|
```bash
|
|
npm install ioredis
|
|
```
|
|
|
|
Stores documents in a specified redis database.
|
|
Expiration property in config can be changed to a value in seconds after which entries will not be served.
|
|
|
|
`redisOptions` object below contains default values, but you can adjust those to match your redis-server configuration. Check [documentation](https://github.com/luin/ioredis/blob/master/API.md#new-redisport-host-options) for more information about accepted values.
|
|
|
|
```json
|
|
{
|
|
"type": "redis",
|
|
"expire": 0,
|
|
"redisOptions": {
|
|
"host": "127.0.0.1",
|
|
"port": 6379,
|
|
"db": 1
|
|
}
|
|
}
|
|
```
|
|
|
|
## RethinkDB
|
|
|
|
Not rewritten yet, to be filled in
|