Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This repository holds a collection of states and modules for deployments using SaltStack. These exist primarily to support the Caktus Django project template.


These states are released under the BSD License. See the LICENSE file for more details.


If you think you've found a bug or are interested in contributing to this project check out margarita on Github.

Development sponsored by Caktus Consulting Group, LLC.


See the CHANGES.rst file for a list of changes in each version of Margarita since we started applying version numbers. The version number in the top entry is the version of Margarita that you're looking at; it's not stored anywhere else for now.

NOTE: We never update the master branch of this repo to avoid causing unexpected upgrade problems for older projects which are tracking the master branch.

To make a new release:

  • Make sure you have no local uncommited changes

  • Make sure you have the latest develop branch locally:

    git checkout develop
    git pull origin develop
  • Pick a new version number, attempting to follow the guidelines of Semantic Versioning.

  • Edit CHANGES.rst with the new version number and the changes since the last release. Pay special attention to documenting any changes that could break projects using older versions of Margarita.

  • Commit those changes.

  • Tag your commit:

    git tag 'X.Y.Z'
  • Push the updated develop branch and the tag:

    git push origin develop --tags
  • If this release is ready to be used by new projects based on our project template, then update margarita_version to this new version in project.sls

States and Variables

There are multiple variables that can be configured for your project. There are also some optional states that are not included in every project by default. This list of states includes documentation about all of the available states and about which variables are configurable. Those variables would be configured in your pillar.

Enable Additional Services

Configuration of various useful services including Github, New Relic, Papertrail, Travis CI, and BitHound is documented on our External Services page.