Skip to content
This repository has been archived by the owner on Aug 28, 2021. It is now read-only.

speckleworks/SpeckleServer

Folders and files

NameName
Last commit message
Last commit date
Jun 23, 2020
Oct 28, 2019
Aug 20, 2020
Nov 25, 2018
Apr 8, 2020
Sep 8, 2019
Jun 23, 2020
Jul 17, 2018
Nov 21, 2019
Feb 15, 2019
Jul 30, 2019
Jul 20, 2018
Mar 17, 2020
Jul 17, 2018
Aug 21, 2019
Apr 11, 2018
Apr 10, 2018
Jun 22, 2020
Apr 11, 2018
Mar 16, 2017
Feb 24, 2018
Jan 29, 2020
Oct 28, 2019
Jun 22, 2020
Feb 9, 2020
Mar 4, 2021
Nov 18, 2020
Dec 4, 2019
Feb 22, 2021
Dec 4, 2019

Repository files navigation

Speckle Server v1

DOI Build status Discourse status GitHub Twitter Follow

This is the Speckle Server, which coordinates communications between the various bits of the Speckle ecosystem.

⚠️ IMPORTANT ⚠️

Speckle v1 has reached EOL and is no longer mainatined. Check out our brand new 👉 Speckle v2! Read more about the announcemnt here and check out or new website.

API

API docs are here - they are a good overview of what you can do.

Installation

The Speckle Server is a nodejs (v.8+, latest stable preffered) app.

  • Dependencies: mongodb and redis.
  • Clone this repo git clone https://github.com/speckleworks/SpeckleServer.git
  • Configuration: create a .env using .env-base as a template, and fill in the required information.
  • Run npm install and thereafter npm run.

⚠️ Warning: if these instructions seem confusing and you want to use speckle in production, please consult someone with more experience! Incorrect configuration can have security and reliability implications.

 Community supported instructions by on how to set up a development server (thanks @arendvw!) can be found in this discourse thread. Feel free to contribute your own experiences there, or ask questions.

🍰 If you just want to try out speckle, at your own risk, you can use https://hestia.speckle.works/api.

Note: hestia is hosted on Digital Ocean. If you want to signup to digital ocean and support the running costs of speckle, use the following affiliate link to get $100 in credit.

To install a front-end plugin, such as the admin ui, clone the respective repo in the plugins folder of the server.

Deploy to Heroku

Deploy

Note: this doesn't include any front-end plugins, so you'll need to interact with a Heroku-hosted server via another front-end, such as https://app.speckle.systems.

Get In Touch

If you have any questions, you can get in touch with the rest of the world-wide specklers via:

License

MIT