Welcome to Gitlab Project Configurator’s documentation!¶
GPC allows you to automatically configure one or several Gitlab Project(s) settings.

You can define your projects configuration in a versionned configuration, following the “Infrastructure as Code” principles.
GPC have multiple purposes, including:
configure a huge number of Gitlab projects at once
test if the desired change is supported by Gitlab before applying to the projects
make sure that all your projects always have the right configuration
ease some configuration (JIRA plugin or webhook configuration for example)
renew / update some critical elements such as CI token for Artifactory or Gitlab
allow derivation from the defined rules for any projects, all described in YAML allowing adding comments and traceabillity
provide several ways of viewing the execution results, either by the stdout, an HTML report or a JSON file.
GPC acts like a “nice guy”, it only changes some project settings you want to enforce, without touching the others. This allows a smooth transition between “everybody does what they want” and “all projects should do this and that”.
Table of Contents
- 1. Quick Guide
- 2. Usage
- 3. Configuration Files Reference
- 4. Command Line Interface
- 5. Known Limitations
- 6. Releases
- 7. Contributing to GPC
- 8. API Reference
- 9. Version history
- 9.1. Version 5.17.3
- 9.2. Version 5.17.2
- 9.3. Version 5.17.0
- 9.4. Version 5.16.0
- 9.5. Version 5.15.0
- 9.6. Version 5.14.2
- 9.7. Version 5.14.1
- 9.8. Version 5.14.0
- 9.9. Version 5.13.0
- 9.10. Version 5.12.0
- 9.11. Version 5.11.2
- 9.12. Version 5.11.0
- 9.13. Version 5.10.0
- 9.14. Version 5.9.0
- 9.15. Version 5.8.4
- 9.16. Version 5.8.3
- 9.17. Version 5.8.2
- 9.18. Version 5.8.1
- 9.19. Version 5.8.0
- 9.20. Version 5.8.0rc0
- 9.21. Version 5.4.0
- 9.22. Version 5.3.0
- 9.23. Version 5.2.0
- 9.24. Version 5.1.0
- 9.25. Version 5.0.0
- 9.26. Version 4.7.0
- 9.27. Version 4.6.0
- 9.28. Version 4.5.0
- 9.29. Version 4.4.2
- 9.30. Version 4.4.1
- 9.31. Version 4.4.0
- 9.32. Version 4.3.2
- 9.33. Version 4.3.1
- 9.34. Version 4.3.0
- 9.35. Version 4.2.0
- 9.36. Version 4.1.0
- 9.37. Version 4.0.0
- 9.38. Version 3.7.3
- 9.39. Version 3.7.2
- 9.40. Version 3.7.1
- 9.41. Version 3.7.0
- 9.42. Version 3.6.1
- 9.43. Version 3.6.0
- 9.44. Version 3.5.0
- 9.45. Version 3.4.0
- 9.46. Version 3.3.1
- 9.47. Version 3.3.0
- 9.48. Version 3.2.1
- 9.49. Version 3.2.0
- 9.50. Version 3.1.0
- 9.51. Version 3.0.2
- 9.52. Version 3.0.1
- 9.53. History before opensourcing GPC