Skip to main content

Getting started

This document will guide you through installing Takaro locally for development. If you are a user of Takaro, you can skip this document and go straight to the User Guide.

The Takaro development environment targets Unix devices (with a focus on Linux)! If you are on Windows, you can use WSL.

System diagram​

Takaro

Requirements​

  • Git
  • Node 18.x
  • Npm 8.x
  • Docker
  • Docker Compose

Development setup​

**If you plan to make code changes, it's a good idea to first create a copy of the repo in your own Github account: Fork the repo **

This is an opinionated development setup. It will get you up and running quickly. It comes with a few services/tools/scripts that are useful for developing, testing and debugging.

Think of this as "Takaro in a box". It is not meant to be used as a production environment, but it will get you up and running quickly.

# Clone the repo
cd /to/where/you/want/to/clone/takaro
git clone [email protected]:gettakaro/takaro.git
cd takaro

# Run the init script from the root of the repo. This will install all development dependencies, it can take a while...
./scripts/dev-init.sh

# While this is running, take a look at the generated .env file and adjust as needed

Start the development environment:

docker compose up --build

At this point, everything should be running. There is a dashboard available where all the services are listed. You can access it at http://localhost:13337.

To view logs:

docker-compose logs -f

# Since Takaro has lots of services, you might want to filter the logs:
# For example, to only see only Takaro logs
docker-compose logs -f takaro

Optionally (but recommended!), you can set up some testing data automatically.

# Generate data for the standard development setup
docker compose exec takaro node scripts/dev-data.mjs