Your lightweight, super fast code hosting and continuous integration service (powered by Drone)
Gitness is building on top of Drone to create a new, open source developer platform with code hosting and pipeline capabilities. Gitness development is taking place in the
master branch. Drone development will continue in the
drone branch until we a ready for our first tagged Gitness release, at which point the project will fully converge.
The latest publicly released docker image can be found on harness/gitness. To try it out, run the command below. Once the container is running, you can visit localhost:3000 in your browser.
docker run \ -p 3000:3000 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v /tmp/gitness:/data \ harness/gitness:latest
The Gitness image uses a volume to store the database and repositories. It is highly recommended to use a bind mount or named volume as otherwise all data will be lost once the container is stopped.
Install the latest stable version of Node and Go version 1.19 or higher, and then install the below Go programs. Ensure the GOPATH bin directory is added to your PATH.
brew unlink protobuf
curl -s https://raw.githubusercontent.com/Homebrew/homebrew-core/9de8de7a533609ebfded833480c1f7c05a3448cb/Formula/protobuf.rb > /tmp/protobuf.rb
brew install /tmp/protobuf.rb
Install protoc-gen-go and protoc-gen-go-rpc:
Install protoc-gen-go v1.28.1
go install firstname.lastname@example.org
(Note that this will install a binary in $GOBIN so make sure $GOBIN is in your $PATH)
Install protoc-gen-go-grpc v1.2.0
go install email@example.com
$ make dep $ make tools
Build the user interface:
$ pushd web $ yarn install $ yarn build $ popd
Build the server and command line tools:
$ make build
This project supports all operating systems and architectures supported by Go. This means you can build and run the system on your machine; docker containers are not required for local development and testing.
Start the server at
./gitness server .local.env
This project includes a full user interface for interacting with the system. When you run the application, you can access the user interface by navigating to
http://localhost:3000 in your browser.
This project includes a swagger specification. When you run the application, you can access the swagger specification by navigating to
http://localhost:3000/swagger in your browser (for raw yaml see
Please make sure to update the autogenerated client code used by the UI when adding new rest APIs.
To regenerate the code, please execute the following steps:
http://localhost:3000/openapi.yamland store it in
The latest API changes should now be reflected in
Please refer to the swagger for the specification of our rest API.
For testing, it's simplest to execute operations as the default user
admin using a PAT:
# LOGIN (user: admin, pw: changeit) $ ./gitness login # GENERATE PAT (1 YEAR VALIDITY) $ ./gitness user pat "my-pat-uid" 2592000
The command outputs a valid PAT that has been granted full access as the user.
The token can then be send as part of the
Authorization header with Postman or curl:
$ curl http://localhost:3000/api/v1/user \ -H "Authorization: Bearer $TOKEN"
This project includes VERY basic command line tools for development and running the service. Please remember that you must start the server before you can execute commands.
For a full list of supported operations, please see
$ ./gitness --help