Skip to content
Switch branches/tags

Latest commit


Git stats


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


This is a contractor management system written in Go that uses politeiad as a backend. It stores invoices, which are submitted by contractors and then approved and paid by administrators.


Core components

  • cmswww - Web server; depends on politeiad.

Tools and reference clients

  • cmswwwcli - Command-line tool for interacting with cmswww.
  • cmswwwdbutil - Tool for debugging and creating admin users within the cmswww database.
  • cmswwwdataload - Tool using cmswwwcli to load a basic dataset into cmswww.

Note: cmswww does not provide HTML output. It strictly handles the JSON REST RPC commands only.


1. Install Go version 1.11 or greater, and Git.

Make sure each of these are in the PATH.

2. Setup and start CockroachDB.

CockroachDB is used by cmswww as storage for users, invoices and other data. Some data, such as invoices, are pulled from politeiad when cmswww starts and are added to the database.

To set up CockroachDB for use with cmswww, you can either do this manually or, on Linux, using go-task if you prefer.

Manual method
  1. Install CockroachDB.

  2. Create the root and cmswwwuser clients, the cmswww database, and a node on localhost.

    Replace <install dir> with the installation location for CockroachDB on your machine:

    cd <install dir>
    mkdir -p ${HOME}/.cmswww/data/testnet3/cockroachdb
    cockroach cert create-ca --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb --ca-key=<install dir>/ca.key --allow-ca-key-reuse
    cockroach cert create-client root --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb --ca-key=<install dir>/ca.key
    cockroach cert create-node localhost --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb --ca-key=<install dir>/ca.key
    cockroach start --host=localhost --http-host=localhost --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb
    cockroach user set cmswwwuser --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb
    cockroach cert create-client cmswwwuser --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb --ca-key=<install dir>/ca.key
    cockroach sql --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb -e 'CREATE DATABASE cmswww'
    cockroach sql --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb -e 'GRANT ALL ON DATABASE cmswww TO cmswwwuser'
    cockroach sql --user=cmswwwuser --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb -e 'GRANT ALL ON DATABASE cmswww TO cmswwwuser'
  3. Start CockroachDB.

    cd <install dir>
    cockroach start --host=localhost --http-host=localhost --certs-dir=${HOME}/.cmswww/data/testnet3/cockroachdb
Task method
  1. Ensure that task is installed

  2. Run task init_cdb

This will run through all the steps described under the manual method above, choosing default folders for the data. Running task init_cdb a second time will delete the database and rerun steps again.

Run task -l to see other commands available. Some additional commands may require that politeiad or cmswww are available on your system.

2. Clone this repository and decred/politeia.

3. Setup configuration files:

Both politeiad and cmswww have configuration files that you should set up to make execution easier. You should create the configuration files under the following paths:

  • macOS

    /Users/<username>/Library/Application Support/Politeiad/politeiad.conf
    /Users/<username>/Library/Application Support/Cmswww/cmswww.conf
  • Windows

  • Ubuntu


Copy and change the sample-cmswww.conf and sample-politeiad.conf files.

You can also use the following default configurations:




rpccert="/Users/<username>/Library/Application Support/Politeiad/https.cert"

Things to note:

  • The rpccert path is referencing a macOS path. See above for more OS paths.

  • cmswww uses an email server to send verification codes for things like new user registration, and those settings are also configured within cmswww.conf. The current code should work with most SSL-based SMTP servers (but not TLS) using username and password as authentication.

4. Build the programs:

cd $GOPATH/src/
GO111MODULE=on go mod vendor && go install -v ./...
cd $GOPATH/src/
GO111MODULE=on go mod vendor && go install -v ./...

5. Start the politeiad server by running on your terminal:


6. Download politeiad's identity to cmswww:

cmswww --fetchidentity

Accept politeiad's identity by pressing Enter.

The result should look something like this:

2018-08-01 22:48:48.468 [INF] CWWW: Identity fetched from politeiad
2018-08-01 22:48:48.468 [INF] CWWW: Key        : 331819226de0270d0c997749ce9f2b56bc5aed110f57faef8d381129e7ee6d26
2018-08-01 22:48:48.468 [INF] CWWW: Fingerprint: MxgZIm3gJw0MmXdJzp8rVrxa7REPV/rvjTgRKefubSY=
2018-08-01 22:48:48.468 [INF] CWWW: Save to /Users/<username>/Library/Application Support/Cmswww/identity.json or ctrl-c to abort

2018-08-01 22:49:53.929 [INF] CWWW: Identity saved to: /Users/<username>/Library/Application Support/Cmswww/identity.json

7. Start the cmswww server by running on your terminal:


At this point, you can:

  • Use the cmswwwcli tool to interact with cmswww.
  • Use the politeia tool to interact directly with politeiad.
  • Use any other tools or clients that are listed above.

Further information

Library and interfaces

  • cmswww/api/v1 - JSON REST API for cmswww clients.


Contractor management system written in Go that uses politeiad as a backend





No releases published


No packages published