BitCurator distro salt states and support files
Branch: master
Clone or download
Latest commit d5fccc0 Jan 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
bitcurator Added brasero Jan 20, 2019
VERSION Reorg and update Feb 19, 2018



GitHub issues GitHub forks

This repo includes relevant salt states and supporting files to build a stack of data analysis, forensics, and security tools using Ubuntu and SaltStack. This build stack is intended to support setup of the BitCurator imaging and disk analysis environment.

Visit to download the latest release built using this repo!

Pre-Installation Setup

Create a fresh Ubuntu 18.04LTS environment in a VM or on a dedicated host with the hostname "bitcurator" and a user named "bcadmin". Login as "bcadmin", and execute the following in a terminal:

sudo apt-get update
sudo apt-get dist-upgrade
sudo apt install git dkms

Installing and preparing SaltStack

Current packaging of SaltStack is available in the 18.04 repositories. Simply run:

sudo apt install salt-minion
sudo service salt-minion stop

Visit for additional details.

Installing and running from this repo

git clone /tmp/salt
sudo salt-call -l info --local --file-root=/tmp/salt state.apply bitcurator.primary

Reboot the VM or host. The environment should now be a fully configured build of BitCurator.

What's in this repository

This repo has been organized to make the process of maintaining and contributing to BitCurator development as transparent as possible. An explanation of the layout follows.

The bitcurator directory contains all support files and salt states in a number of different directories:

  • attic: Legacy and unused files that have been kept for reference or potential future use
  • config: Salt states and support files for environment and user configuration
  • debs: Deb packages that are required but do not have a stable external home
  • env: Environment support files and salt states for the user desktop and various tools
  • externals: Source packages that are either not deb packaged or for which a legacy version is required
  • mounter: Mount policy tools
  • packages: all deb packages (to be installed with apt-get)
  • python-packages: all Python 3 packages (to be installed with pip)
  • repos: additional repositories that must be enabled
  • tools: tools that must be installed from source

Alternate Build and Configuration Options (not required for regular build)

Installing only select packages

sudo salt-call --local --file-root=/tmp/bitcurator state.sls bitcurator.packages,bitcurator.python-packages

Salt may also be installed from a dedicated repo (if needed for alternate buidls):

wget -O - | sudo apt-key add -
echo "deb bionic main" | sudo tee /etc/apt/sources.list.d/saltstack.list
sudo apt-get update
sudo apt-get install salt-minion
sudo service salt-minion stop

BitCurator documentation, help, and other information

User documentation and additional resources are available on the BitCurator Environment wiki.

Questions and comments can also be directed to the bitcurator-users list.


The BitCurator logo, BitCurator project documentation, and other non-software products of the BitCurator team are subject to the the Creative Commons Attribution 4.0 Generic license (CC By 4.0).

Unless otherwise indicated, software items in this repository are distributed under the terms of the GNU General Public License v3.0. See the LICENSE file for additional details.

In addition to software produced by the BitCurator team, BitCurator packages and modifies open source software produced by other developers. Licenses and attributions are retained here where applicable.

Development Team and Support

The BitCurator environment is a product of the BitCurator team housed at the School of Information and Library Science at the University of North Carolina at Chapel Hill. Funding between 2011 and 2014 was provided by the Andrew W. Mellon Foundation.

Ongoing support for the BitCurator environment is managed by the BitCurator Consortium. Find out more at: