kerberusio/jsonstash-web-service repository overview

⁠jsonstash-web-service

A free self-hosted JSON storage solution.

⁠Getting Started

Learn about the endpoints at docs.jsonstash.com⁠ or the swagger docs upon deploying the service http(s)://<IP_ADDRESS>|<HOST_NAME>[:<PORT>]/swagger.

⁠Prerequisities

In order to run this container you'll need docker installed.

• Windows⁠
• OS X⁠
• Linux⁠

⁠Usage

⁠Environment Variables

• DefaultConnection - The path where you want the sqlite database stored. Example: Data Source=/app/Data/jsonstash.db.
• Administrators - Comma seperated list of emails. A user is created with an email in this list are assigned the role: "Administrator".
• StashNameMaxLength - Max number of chars allowed to be used when naming a stash.
• LoginAttemptThreshold - Max number of failed login attempts before locking the user out.
• AccessKey - Required when creating a new user. Must be a GUID.
• JWTSecret - Json Web Token secret. Must be a GUID.
• JWTExpiresIn - The amount of time in minutes till the token expires.
• JWTRefreshTokenExpiresIn - The amount of time in days till the refresh token expires..
• EmailHost - SMTP email host to send unlock tokens.
• EmailPort - SMTP host port.
• EmailUsername - Email used to authenticate to host.
• EmailPassword - Password used to authenticate to host.

⁠Volumes

• /your/file/location - File location

⁠Built With

• C# .NET 7
• Newtonsoft.Json v13.0.2⁠
• SQLite⁠

⁠Authors

• Lincoln Hach Yellick - LinkedIn⁠

⁠License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE.md⁠ file for details.

⁠Acknowledgments

• Thanks to my wife and kids who I love. They didn't help with this at all, but I just like saying it.