The preferred installation method for DIGITS is using pre-built packages on Ubuntu 14.04 (instructions).
If those don't work for you for some reason, the following instructions will walk you through building the latest version of DIGITS from source. These instructions are for installation on Ubuntu 14.04 and 16.04.
Alternatively, see this guide for setting up DIGITS and Caffe on Windows machines.
Other platforms are not officially supported, but users have successfully installed DIGITS on Ubuntu 12.04, CentOS, OSX, and possibly more. Since DIGITS itself is a pure Python project, installation is usually pretty trivial regardless of the platform. The difficulty comes from installing all the required dependencies for Caffe and/or Torch7 and configuring the builds. Doing so is your own adventure.
Install some dependencies with Deb packages:
sudo apt-get install --no-install-recommends git graphviz python-dev python-flask python-flaskext.wtf python-gevent python-h5py python-numpy python-pil python-pip python-protobuf python-scipy
Follow these instructions to build Caffe (required).
Follow these instructions to build Torch7 (suggested).
# example location - can be customized DIGITS_ROOT=~/digits git clone https://github.com/NVIDIA/DIGITS.git $DIGITS_ROOT
Throughout the docs, we'll refer to your install location as
~/digits in this case), though you don't need to actually set that environment variable.
Several PyPI packages need to be installed:
sudo pip install -r $DIGITS_ROOT/requirements.txt
[Optional] Enable support for plug-ins
DIGITS needs to be installed to enable loading data and visualization plug-ins:
sudo pip install -e $DIGITS_ROOT
Starting the server
Starts a server at
$ ./digits-devserver --help usage: __main__.py [-h] [-p PORT] [-d] [--version] DIGITS development server optional arguments: -h, --help show this help message and exit -p PORT, --port PORT Port to run app on (default 5000) -d, --debug Run the application in debug mode (reloads when the source changes and gives more detailed error messages) --version Print the version number and exit
Now that you're up and running, check out the Getting Started Guide.
Most configuration options should have appropriate defaults. Read this doc for information about how to set a custom configuration for your server.