Speckle Server
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
™️ (with Digital Ocean)
5 Minute Docker Install 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-base
file 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:
$ redis-server
-
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
API docs are here - they are a good overview of what you can do with the speckle server.
Current Limitations
- 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.
Credits
Developed by Dimitrie A. Stefanescu @idid and Project Contributors.