Turtl’s server is written in Common Lisp. It can take a few minutes to set up, so be sure to read this guide carefully.
Let’s go over the software you need to get started.
Turtl loads all of its dependencies through the Quicklisp system. So install Quicklisp using your lisp of choice from above.
Turtl’s data store is RethinkDB, so you’ll need to install that on your server.
Turtl fully manages its own schema and doesn’t require any setup beyond getting RethinkDB created.
The server is evented, and requires that you have libuv installed on the machine you with to run Turtl.
Now that you have all the software you need ready to go, download the Turtl API via git:
git clone https://github.com/turtl/api.git
Go into the
api/ folder, and copy
config/config.lisp using your favorite editor and
update the settings to suit your needs. All the options are fairly well
While still in the
api/ folder, open your chosen lisp and run:
If all goes well, Turtl will create the schema it needs and open on port 8181! You can now point your clients at this port on your server, although it’s recommended to run it behind a proxy like Apache or Nginx.
Here are a set of community-built docker containers available for running the Turtl API (no official containers yet):