A configurable and versatile update server for all your Electron apps
Clone or download
Latest commit dc1780a Sep 18, 2018
Permalink
Failed to load latest commit information.
docs feat(core-platform): deterministically generate the RELEASES file for… Jul 2, 2018
public fix: stringify team before sending Aug 21, 2018
src fix: sanitze the cloudfront key for all uses Sep 18, 2018
typings feat(core-platform): deterministically generate the RELEASES file for… Jul 2, 2018
.cz.js feat: remove nucleus-uploader as the publisher now lives in electron-… May 8, 2018
.dockerignore feat: automated docker builds of nucleus May 21, 2018
.gitignore Initial Commit Nov 20, 2017
.npmignore feat: remove nucleus-uploader as the publisher now lives in electron-… May 8, 2018
.travis.yml build: add required packages to travis yml Jul 2, 2018
CHANGELOG.md updated CHANGELOG.md Sep 18, 2018
CODE_OF_CONDUCT.md Initial Commit Nov 20, 2017
Dockerfile perf: reduce docker image size by ~500MB Jun 28, 2018
LICENSE Initial Commit Nov 20, 2017
README.md feat(core-platform): deterministically generate the RELEASES file for… Jul 2, 2018
config.template.js feat(core-platform): add defaultRollout config option to the nucleus … Jun 29, 2018
package.json 1.1.3 Sep 18, 2018
postcss.config.js Initial Commit Nov 20, 2017
tsconfig.json feat(core-platform): host the public key of the gpg key pair on the f… Mar 26, 2018
tsconfig.public.json Initial Commit Nov 20, 2017
tsconfig.test.json Initial Commit Nov 20, 2017
tslint.json Initial Commit Nov 20, 2017
webpack.config.js fix(tooling): fix typo in webpack config Mar 5, 2018
webpack.loaders.js Initial Commit Nov 20, 2017
webpack.production.config.js Initial Commit Nov 20, 2017
yarn.lock test: add tests for the rest API (health, deep, app) Jun 30, 2018

README.md

Nucleus Server

Build Status npm status

A configurable and versatile update server for all your Electron apps

Features

  • Multiple applications
  • Multiple channels for each application
  • Companion publisher for electron-forge to greatly simplify release publishing
  • Backed by a static file store so minimal server costs
  • One command to run so insanely simple to set up
  • Staged Rollouts
    • macOS
    • Windows
  • Latest Downloads - Static URL's for downloading the latest version of your application
  • Platform Support:
    • macOS
    • Windows
    • Linux - RedHat
    • Linux - Debian

Stable Version

The currently "stable" version is v0.8.3, unless you want a walk on the wild side. Please stick to that release.

Electron Version Requirements

Please note that using Nucleus requires that you use Electron >=2.0.0.

Setup

Docker

You'll need to set up your own docker image using a Dockefile like below.

FROM atlassian/nucleus

COPY config.js /opt/service/config.js

Then running your built docker image will run nucleus on port 8080.

Manual

git clone git@github.com:atlassian/nucleus.git nucleus-server
cd nucleus-server
cp config.template.js config.js
yarn
yarn dev

This will launch Nucleus running on your local machine with a local file store and a SQLite database.

Configuration

All the config options are thoroughly documented and explained in the config.template.js file in this repository.

Uploading Releases

Release uploading is explained inside Nucleus itself, for more advanced information check out the Uploading Docs.

More Information

Please see the following documents for more information on Nucleus and how it works.

FAQ

Why does this use a static file store, why not use a traditional update server?

$$$, static file stores quite simply cost less to run than arrays of update servers

Can I use CloudFront to speed up my downloads?

Yes, check out the CloudFront section of the S3 config inside config.template.js.

How do I switch to this from Update Server X?

Switching update servers in an Electron app is quite simple

  1. Modify your autoUpdater code to point to this server (follow the instructions on your app page inside Nucleus)
  2. Release a new update for your application on your existing update server with this change
  3. Release all future updates on Nucleus :)

Is this really awesome?

Pretty sure it is :D

How do I set this up in a production environment?

You can use the published version of this module nucleus-server which has an exported CLI command (nucleus). You then run the command with the first argument being a path to your config file. E.g.

NODE_ENV=production nucleus path/to/config.js

Please ensure you add redis session config and a proper (not local) authentication method when running in a production environment.

To enable logging you need to set DEBUG=nucleus*.

System Requirements

  • Node >= 8
  • Yarn
  • Linux
    • createrepo
    • rpmsign
    • dpkg-scanpackages
    • dpkg-scansources
    • gpg
    • apt-ftparchive
  • macOS / Windows
    • docker
    • gpg

Contributors

Pull requests, issues and comments welcome. For pull requests:

  • Add tests for new features and bug fixes
  • Follow the existing style
  • Separate unrelated changes into multiple pull requests

See the existing issues for things to start contributing.

For bigger changes, make sure you start a discussion first by creating an issue and explaining the intended change.

Atlassian requires contributors to sign a Contributor License Agreement, known as a CLA. This serves as a record stating that the contributor is entitled to contribute the code/documentation/translation to the project and is willing to have it used in distributions and derivative works (or is willing to transfer ownership).

Prior to accepting your contributions we ask that you please follow the appropriate link below to digitally sign the CLA. The Corporate CLA is for those who are contributing as a member of an organization and the individual CLA is for those contributing as an individual.

Team

Samuel Attard
Samuel Attard

License

Apache 2.0 © Atlassian Pty Ltd