1
0
mirror of https://github.com/etesync/server synced 2024-11-16 05:48:59 +00:00
Go to file
2018-02-18 14:19:29 +10:00
etesync_server Refactor out the secret.txt file handling to a utils module 2018-02-18 14:19:29 +10:00
.gitignore Use secret.txt file auto-generated in project root as default SECRET_KEY 2018-02-18 13:43:29 +10:00
LICENSE Initial commit: add license. 2017-11-02 22:12:17 +00:00
manage.py Initial commit of the actual server code. 2017-11-19 21:36:48 +00:00
README.md README: Add a note about supporting etesync. 2017-11-29 17:59:59 +00:00
requirements.txt Change requirements.txt to allow updating to latest patch version 2018-02-18 13:35:23 +10:00

A skeleton app for running your own EteSync server

Installation

To setup your own EteSync server based on the git version just clone this git repository and set up the django app:

git clone https://github.com/etesync/server-skeleton.git

cd server-skeleton

# Set up the environment and deps
virtualenv .venv
source .venv/bin/activate

pip install -r requirements.txt

Set the django SECRET_KEY and ALLOWED_HOSTS in the settings file. For more information on these please refer to the django deployment checklist.

Now you can initialise our django app

./manage.py migrate

And you are done! You can now either run the debug server just to see everything works as expected by running:

./manage.py runserver 0.0.0.0:8000

Using the debug server in production is not recommended, so you should configure your webserver to serve etesync (with TLS). An example on how to do so with nginx can be found here.

Usage

Create yourself an admin user:

./manage.py createsuperuser

At this stage you can either just use the admin user, or better yet, go to: www.your-etesync-install.com/admin and create a non-privileged user that you can use.

That's it!

Now all that's left is to open the EteSync app, add an account, and set your custom server address under the "advance" section.

Supporting EteSync

Please consider registering an account even if you self-host in order to support the development of EteSync, or help by spreading the word.