Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Graveyard: Place for Dead (and Undead)

Graveyard is an attempt at open-source reimplementation of (referred to as DDCZ in this text).

Developer's documentation is at Read the Docs.


Contributions are welcome provided you agree your work will be shared under the same license as Graveyard (MIT).

If you don't know where to start, take a look at issues or ask Almad on development Slack or in Pošta on


You can run Graveyard either directly on your machine or inside Docker.

Installing and running Graveyard directly is faster (on some systems) and removes one lever of indirection, but it makes the setup more complicated.

Running in Docker requires familiarity with it, but it makes setup easier and guarantees consistency with the testing environment (and hopefully in the future, production environment as well).

In both cases, first clone this repository and run all commands in its directory.

Installing in Docker


Verify you have everything ready by running the test suite:

  • docker-compose run web python3 test

If you see output like this:

(graveyard-venv) almad@zeruel:~/projects/graveyard$ docker-compose run web python3 test
Starting graveyard_db_1 ... done
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
Ran 4 tests in 0.000s

Destroying test database for alias 'default'...
(graveyard-venv) almad@zeruel:~/projects/graveyard$ 

You are all set. Afterwards, install database schema by running

  • docker-compose run web python3 migrate

and load data about pages

  • docker-compose run web python3 loaddata pages

You are done! Now you can just run the project and develop using

  • docker-compose start

Installing on your machine

Graveyard is currently written in Django. Requirements to develop it:

  • You have working Python 3 installation on your machine
  • You have working MySQL installation on your machine

To use the project, clone this repository and:

  • Create a virtual environment: python3 -m venv gvenv
  • Enter it (on Mac OS X or Linux): source gvenv/bin/activate
  • Install dependencies within the
  • Copy settings template: cp graveyard/settings/ graveyard/settings/
  • Edit the settings above, especially enter credentials to your local MySQL
  • Verify you have correct installation and run tests with python test. You should see output like this:
(graveyard-venv) almad@zeruel:~/projects/graveyard$ python test
Creating test database for alias 'default'...
System check identified no issues (0 silenced).
Ran 11 tests in 0.031s

Destroying test database for alias 'default'...
(graveyard-venv) almad@zeruel:~/projects/graveyard$ 
  • Create the database schema: python migrate
  • Load data about pages to see what's on production: python loaddata pages
  • Run the thing! python runserver
  • Observe if you have contact at http://localhost:8000
  • Maybe create a superuser in order to enter admin: python createsuperuser
  • Look around the administration interface at http://localhost:8000/admin/

Installation issues

  • Installation failes with "mysql_config not found"

If you get something like this:

    File "/tmp/pip-install-wfhe9zue/mysqlclient/", line 29, in mysql_config
        raise EnvironmentError("%s not found" % (_mysql_config_path,))
    OSError: mysql_config not found

you may be using MariaDB fork of MySQL that the Python client is not equipped to talk to, installation-wise. You need to manually symlink the appropriate command:

ln -s /usr/bin/mariadb_config /usr/bin/mysql_config

If even mysql_config is not there, you have to install development headers for the database. That's apt-get install libmariadbclient-dev on Debian.

  • error: invalid command 'bdist_wheel'

Old setuptools: pip install setuptools -U