Copy the examples in
.envs_template to a new
.envs directory within the Ghostwriter directory.
mkdir .envs && cp .envs_template/.* .envs
.envs directory contains
.production directories. Each of these directories contains the same two files,
.postgres. These files manage the settings for Docker. Edit the
.django file to add API keys and manage other options.
One action Ghostwriter can perform is looking-up domain names and servers in VirusTotal. This uses web requests and a VirusTotal API key. If you do not have one, get a free API key from VirusTotal. Once you have your key, set
If you desire to use Slack with Ghostwriter, set
True and then configure a Slack Incoming WebHook.
You can also specify a username and emoji for the bot. Emojis must be set using Slack syntax like
:sheep:. The username can be anything you could use for a Slack username. The emoji will appear as the bot's avatar in channels.
The alert target is the message target. You can set this to a blank string, e.g.
'', but it's useful for targeting users, aliases, or @here/@channel.
Finally, set the target channel. This might be your
#general or some other channel. This is the global value that will be used for all messages unless a project-specific channel is supplied. When a new project is created, users have an option to provide a Slack channel to be used for project-related notifications instead of the global channel.
Other notification options may be added in the future. Email and services such as Pushover are being considered. That said, you can add your own notification mediums and tasks in tasks.py. See Background Tasks for more information.
At the bottom of of the settings you will find some values for your company/team. Fill these in to customize reporting. You need to provide at least a company name. Set values to blanks if you do not want to use them (e.g.
COMPANY_TWITTER = '').
Once you have
.envs setup, check Docker to make sure it is running. Then start the Docker container using the
docker-compose -f local.yml up -d
If you have already built Ghostwriter before and have made custom changes or pulled down new code, update and rebuild the container using these four commands:
docker-compose -f local.yml stop; docker-compose -f local.yml rm -f; docker-compose -f local.yml build; docker-compose -f local.yml up -d
Proceed to Database Setup.