jgeskens/standardfile repository overview

⁠Standard File Server, Ruby Implementation

This is a production-ready reference implementation of the Standard File⁠ protocol.

A production client is available at https://app.standardnotes.org⁠

⁠Running your own server

You can run your own Standard File server, and use it with any SF compatible client (like Standard Notes). This allows you to have 100% control of your data. This server implementation is built with Ruby on Rails and can be deployed in minutes.

⁠Getting started

Requirements

• Ruby 2.2+
• Rails 5
• MySQL database

Instructions

1. Clone the project:

   git clone https://github.com/standardnotes/ruby-server.git
   

   Copy

2. Create a .env file in the project's root directory. Add environment variables (see Environment variables for full listing):

   DB_HOST=localhost
   ...
   

   Copy

3. Initialize project:

   bundle install
   rails db:create db:migrate
   

   Copy

4. Start the server:

   rails s
   

   Copy

⁠Deploying to a live server

You can find instructions on deploying an SN server from scratch here:

Deploying a Standard File server with Amazon EC2 and Nginx⁠

⁠Environment variables

DB_HOST

Database host.

DB_PORT

Database port. 3306 is standard.

DB_DATABASE

Database name.

DB_USERNAME

Database username.

DB_PASSWORD

Database password.

⁠Contributing

Contributions are encouraged and welcome. Currently outstanding items:

• Test suite

⁠License

Licensed under the GPLv3: http://www.gnu.org/licenses/gpl-3.0.html⁠