This is the Speckle Server, which coordinates communications between the various SpeckleClients.
Speckle Server provides :
- a basic accounts system
- stream coordination
- design data collation and retrieval
- live update events
- a basic querying mechanism
5 Minute Docker Install
™️ (with Digital Ocean)
Head over to Digital Ocean and create an account. Subsequently, create a new droplet (vm) via "One Click Apps" and select "Docker". Finally,
ssh into your new virtual machine.
Execute the following commands:
$ mkdir speckle && cd speckle $ curl https://raw.githubusercontent.com/speckleworks/SpeckleServer/master/docker-compose.yml -o docker-compose.yml $ docker-compose up
Note: You're not restricted to digital ocean. Any machine with docker should be ok.
Deploying to Heroku
$ heroku create --stack cedar $ heroku addons:create mongolab:sandbox $ heroku addons:create heroku-redis:hobby-dev $ git push heroku master $ heroku open
Deploying on Debian-based OSes (Ubuntu etc)
Install mongodb, redis servers and npm:
$ sudo apt-get install mongodb redis npm
If you don't want both the redis and mongo servers running all the time (For ex. if you are just testing), disable both startup scripts (If you wish to leave both running automatically, skip to step 4):
$ sudo systemctl disable mongodb $ sudo systemctl disable redis-server`
And stop both mongo and redis processes that were started automatically by apt-get:
$ sudo systemctl stop mongodb $ sudo systemctl stop redis-server
Clone SpeckleServer and run npm to install the needed nodejs packages:
$ git clone https://github.com/speckleworks/SpeckleServer.git $ cd SpeckleServer $ npm install
Follow the instructions in
.env-basefile to configure your server.
Start mongo (create a folder somewhere to store the db):
$ mongodb --dbpath /path/to/some/folder
Start redis in another terminal:
Check that both mongo and redis are running OK and that you can connect to them with these two clients:
$ mongo $ redis-cli
Start Speckle in a third terminal:
$ node server.js
API docs are here - they are a good overview of what you can do with the speckle server.
- Because we rely on mongodb's wired tiger engine, objects larger than 16mb will cause trouble. Unfortunately, most of the defenses are on the client side.
- The api will refuse payloads larger than MAX_REQ, which defaults to 10mb.
Developed by Dimitrie A. Stefanescu @idid and Project Contributors.