# Turtl

> Open-source, self-hosted backend server for Turtl clients: account management, data storage, syncing, sharing permissions and a plugin architecture, on Node and Postgres.

- **Category:** Notes & Editors
- **Licence:** AGPL-3.0
- **Latest version:** 0.7.0
- **Open source:** oss
- **Languages:** JavaScript
- **Platforms:** Docker Compose, Node.js
- **Tags:** SMTP, Sharing, Object Storage, Notes, Plugin System, Node.js, Agpl, Account management, Postgres, Sync Server, Notebook Backend

## Description

Turtl server is the backend that Turtl clients talk to: it covers account management (join, login and delete), data storage, syncing and permissions/sharing. Written in Node.js with PostgreSQL as its datastore, it exposes a plugin architecture so optional pieces like analytics or payment processing can be added without any particular provider being forced on you. You can run it directly (clone the repo, npm install, copy config/config.yaml.default to config/config.yaml, initialize the database with ./scripts/init-db.sh, then start node server.js) or with docker-compose, which also spawns a Postgres container and serves the API on port 8181. In Docker, any setting in config.yaml can be overridden through environment variables with a TURTL_ prefix. Uploaded files go either to the local filesystem or to an S3-compatible bucket, and email notifications are available through an SMTP plugin. The repository has no tagged releases and its last push was in March 2024; the project itself notes that running your own server is off the supported path.

## Links

- [Homepage](https://github.com/turtl/server)
- [Turtl project tracker (issue tracker)](https://github.com/turtl/project-tracker/issues)
- [Turtl GitHub organization](https://github.com/turtl)

---
Source: https://selfhost.directory/project/turtl