Scheduler (HTTP API and webapp) for running Mesos tasks—long running processes, one-off tasks, and scheduled jobs. #hubspot-open-source
Switch branches/tags
Clone or download
ssalinas Merge pull request #1851 from HubSpot/no_lsof
lsof alternative for open files check
Latest commit bb31baf Sep 17, 2018
Failed to load latest commit information.
Docs Update Jun 11, 2018
EmbedSingularityExample Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
SingularityBase Remove sort in getPortByIndex Aug 27, 2018
SingularityClient Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
SingularityExecutor Customizable bash in startup script Aug 27, 2018
SingularityExecutorCleanup Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
SingularityMesosClient new strategy for new host overlaod check Aug 9, 2018
SingularityRunnerBase Alternative to lsof for checking file open Sep 13, 2018
SingularityS3Base Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
SingularityS3Downloader Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
SingularityS3Uploader Add as arg in isFileOpen call Sep 13, 2018
SingularityService Merge pull request #1839 from HubSpot/get_port_fix Sep 10, 2018
SingularityServiceIntegrationTests Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
SingularityUI More descriptive empty table message on requests page Aug 28, 2018
cookbook remove old vargrant and cookbook stuff as well Nov 1, 2016
eclipse horizon related changes Sep 24, 2014
mysql Updated mysql index on startedAt Feb 27, 2017
scripts add logfetch build Oct 2, 2017
styles fix gitbook, add missing annotations Nov 17, 2016
.blazar-enabled Move the static assets for Singularity into the SingularityUI Jar, an… Sep 29, 2017
.blazar.yaml Fix sanpshot versions in .blazar.yaml files Jul 15, 2018
.bookignore updates to release and docs scripts Dec 9, 2016
.gitignore use gitbook for docs Mar 14, 2016
.hubspot-blazar-discovery.yaml Build Singularity on Blazar Sep 29, 2017
.travis.yml skip install and run all in script Aug 28, 2018
LICENSE more tweaks to gitbook config, add logo, fix LICENSE, publish script Mar 16, 2016 Grammar and formatting fixes May 9, 2017 add newer PRs and auth docs Nov 17, 2017
book.json Add 0.20.1 release docs Jun 20, 2018
compose-dev.yml Bump docker compose versions for new release Jul 10, 2018
dev Easier setup for local dev with SingularityService Nov 17, 2017
docker-compose.yml Bump docker compose versions for new release Jul 10, 2018 update docker release script Mar 17, 2017 Release docs for 0.13.0 Dec 9, 2016 Bump version numbers in documentation May 8, 2017
pom.xml [maven-release-plugin] prepare for next development iteration Jun 20, 2018 gitbook publish fixes Dec 9, 2016 add set env May 1, 2017


Latest Release Version: 0.14.1

Mesos Version: 0.28.2

Build Status


Singularity is an API and web application for running and scheduling Apache Mesos tasks — including long running processes, scheduled jobs, and one-off tasks.

It focuses on a batteries-included approach: Singularity and its components provide an entire Platform as a Service (PaaS) to end-users. It has many features which have been introduced to reduce developer friction and ensure proper operation and reliable deployment of tasks. Users may even be unfamiliar with and shielded from the details of Mesos.

For a more thorough explanation of the concepts behind Singularity and Mesos click here.


Try It Out!

If you want to give Singularity a try, you can install docker and docker-compose to run our example cluster.

Run docker-compose pull first to get all of the needed images. Note: This may take a few minutes

Then simply run docker-compose up and it will start containers for...

  • mesos master
  • mesos slave (docker/mesos containerizers enabled)
  • zookeeper
  • Singularity
  • Baragon Service for load balancer management
  • Baragon Agent + Nginx as a load balancer

...and the following UIs will be available:

if using boot2docker or another vm, replace localhost with the ip of your vm

Getting Started






Singularity is built and used by a number of different companies. Check out the list of adopters here.