Ailur
/
fulgens
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
The Fulgens Plugin-based web server (beta)
10 Commits 1 Branch 19 Tags 12 MiB
Go 79.8%
JavaScript 10.8%
HTML 5.1%
CSS 3.2%
Shell 1.1%
Go to file
Tracker-Friendly 755a600418 Made the tokens contain the actual sub 
Signed-off-by: Arzumify <jliwin98@danwin1210.de>
 		2024-10-02 17:52:47 +01:00
library Removed the serviceInitialisationInformation give a ServiceID, because it's not needed 2024-10-02 17:07:01 +01:00
services-src Made the tokens contain the actual sub 2024-10-02 17:52:47 +01:00
.gitignore Updated gitignore to not have git scream at me during every test 2024-09-29 16:07:04 +01:00
LICENSE.md Initial commit 2024-09-28 19:41:34 +01:00
README.md Updated the blob storage service to not be... broken 2024-09-29 19:03:13 +01:00
build.sh Initial commit 2024-09-28 19:41:34 +01:00
config.json Updated the blob storage service to not be... broken 2024-09-29 19:03:13 +01:00
go.mod Updated PoW library, removed unused graphics, moved checking client token validity serverside in clientKeyShare, made not having a user account not crash the app, made the PoW easier and have a cleaner interface, fixed some elements in dark mode, optimised 0px -> 0 in some CSS, updated some packages 2024-09-29 16:06:28 +01:00
go.sum Whoops, forgot to update the Chi middleware :P 2024-09-29 18:54:30 +01:00
main.go Removed the serviceInitialisationInformation give a ServiceID, because it's not needed 2024-10-02 17:07:01 +01:00

README.md

Fulgens Web Server

A simple and fast plugin-based web server written in Golang.

Go Report Card Go Reference wakatime

It utilises Chi and the Go standard library to provide a fast and efficient web server, with the ability to add plugins to extend its functionality.

Features

  • Fast and efficient
  • Plugin-based
  • Easy to use
  • Comes with OAuth2 and Blob storage (known as the "nucleus" services)
  • SQLite and PostgreSQL support
  • Easy to extend

Installation

To install, git clone the repository:

git clone https://git.ailur.dev/Ailur/fulgens.git --depth 1

Then, build the server:

./build.sh

Usage

To run the server, simply run the binary:

./fulgens

Configuration

The server can be configured using a config.json file. An example configuration file is provided in the repository.

Global

  • port - The port the server listens on
  • ip - The IP address the server listens on
  • serviceDirectory - The directory where services are stored
  • resourceDirectory - The directory where service resources are stored

Logging

  • enabled - Whether file logging is enabled
  • file - The file to log to

Database

  • type - The type of database to use (sqlite or postgres)
  • connectionString - The connection string for the database (postgres only)
  • databasePath - The directory to store the databases (sqlite only) It is necessary to have a separate directory for each service, as SQLite does not support multiple schemas in a single file.

Services

For all services

  • subdomain - The subdomain the service is hosted on (optional, will run on the root domain if not specified)

Storage

  • path - The path to store blobs
  • defaultQuota - The maximum size of the storage in bytes

Auth

  • privacyPolicy - The URL to the privacy policy
  • url - The URL it is being hosted on
  • testAppEnabled - Whether to enable the OAuth2 test app
  • testAppIsInteralApp - Whether the test app should have seamless logon like an internal service (required if testAppEnabled is true)
  • identifier - The name of the OAuth2 service
  • adminKey - The key used to access the admin panel and list users

Contributing

Contributions are welcome! Please open a pull request with your changes.

Plugin development

Plugins require the use of the library package, found here. This provides them with the necessary resources to interact with the rest of the server

Enterprise support

For enterprise support, please visit Ailur Enterprise.