Project Citadel - An open source project management tool

Overview

A free & open source alternative project management tool.

Please note that this project is still in active development. Some options may not work yet!

Currently citadel only offers basic task tracking through a Kanban board.

Currently you can do the following to tasks:

You'll need both docker & docker-compose installed.

First clone the repository:

git clone https://github.com/JordanKnott/project-citadel && cd project-citadel

Now do the following:

docker-compose -p citadel up -d
docker-compose -p citadel -f docker-compose.yml -f docker-compose.migrate.yml run --rm migrate

This will start a postgres instance as well as a citadel instance.

The second command runs the database schema migrations.

If you visit http://localhost:3333, you will get redirected to the installation screen so that you can create the first system user.

You'll need Golang installed on your machine.

Next, clone the repository:

git clone https://github.com/JordanKnott/project-citadel && cd project-citadel

Next we need to build the binary. This project uses Mage for its build tool.

go run cmd/mage/main.go install
go run cmd/mage/main.go build

This will:

The newly created citadel binary can be found in the dist folder.

It contains everything neccessary to run except the config file. An example config file can be found in conf/app.example.toml

The config will need to be copied to a conf/app.toml in the same place the binary is.

Make sure to fill out the database section of the config in order to connect it to your database.

Then run the database migrations with citadel migrate.

Now you can run the web interface by running citadel web

This is a list of features that will eventually be added to Citadel in no particular order: