Importing Repositories

You need to import the repositories into ToxicBuild to be able to have continuous integration. Repositories can be imported from GitHub, from gitlab or can be added manually.

Importing repositories from GitHub

First configure the Integration with Github then go to http://localhost:8888/settings/repositories and click in the GitHub link:

Adding new github repository

You will be redirected to Github and can choose which repositories you want imported into ToxicBuild.


After you select your repositories and install, you will be redirect to the ToxicBuild web ui again and that’s it. Your repositories will be imported.

Importing repositories from Gitlab

First configure the Integration with Gitlab then go to http://localhost:8888/settings/repositories and click in the gitlab link:

Adding new Gitlab repository

The Gitlab does not have an option to select the repositories you want imported, so all your repositories will be imported, but you can enable/disable repositories at http://localhost:8888/settings/repositories

Disabling repositories

Adding repositories manually

If you do not use github, gitlab or do not want import your repositories automatically, you can add them by hand. Go to http://localhost:8888/repository/add:


  • Name - An unique name for the repository
  • URL - The clone URL of the repository

Repository advanced configuration

When you click in the advanced link in the repository settings page these are the available options:

Repository advanced configuration

  • Branches - Configure which branches trigger can builds. If no branches configuration, all branches will trigger builds. The branches configuration has the following options:

    Repository branch configuration

    • Name - The branch name. You can use wildcards here.
    • Only most recent changes - If checked when a bunch of commits are pushed at the same time only the most recent will trigger builds
  • Parallel builds - How many parallel builds this repository can run. If no parallel builds there is no limit.

  • Environment variables - Environment variables that will be present in the build environment.

    Repository envvars configuration

    • Key - The environment variable name
    • Value - The value of the variable
  • Slaves - Which slaves can execute builds for the repository. If a repository don’t have any enabled slave no builds will be executed.