~nicohman/raven/ravenserver

Table of Contents

This commit

commit 9f9b0f280b298fd5cbf9dc8758b70ca71208fce1
Author: nicohman <nicohman@demenses.net>
Date:   2019-02-01T19:03:01

Add new fields to config docs
Clone this wiki
man@man.sr.ht:~nicohman/raven
https://man.sr.ht/~nicohman/raven

Ravenserver Documentation

ravenserver is a NodeJS-based online repository/package manager for raven themes. You can write your own client or bot easily using the API if you want.The main instance runs on my website, and raven comes configured with that by default, but you can swap to your own easily.

REST API

Installation

To set up your own instance, it's pretty easy. First, grab the code:

git clone https://git.sr.ht/~nicohman/ravenserver

Create a file named config.json in the directory you cloned, containing these fields:

{
    "email":{
        // This is the email address that emails should be sent from
        "user": String,
        // This is the host that ravenserver wll use to send the emails
        "host": String,
        // This is the password to the email account
        "pass": String, 
    },
    // This controls whether or not to display a link to the downloads page. You should probably leave this off.
    "include_downloads": Boolean,
    // The page to redirect users to on clicking the download page link
    "downloads_page": String,
    // The secret to sign JWT tokens with
    secret: String
}

Then, you'll need to set up a MongoDB database on the server. It should be named themes, and ravenserver will handle the rest of the setup. Now, you're pretty much ready to go. Just start it up!

node app.js

I personally recommend using pm2 to manage it.

pm2 start app.js