Hosted repositories#
To run a solver on QCentroid, its source code has to live in a Git repository (a versioned folder of code). Normally you would keep that code on an external provider such as GitHub or GitLab. With hosted repositories, QCentroid hosts it for you instead — on its own Git server — so you don’t need any external provider or extra setup.
If you are new to this, don’t worry: everything is created and managed for you from the QCentroid platform. This page explains how it all fits together.
How it works#
When hosted Git is enabled for your organization, QCentroid sets up a few things for you on its Git server (https://git.sandbox.qcentroid.com/):
- Your own organization on the Git server. All your hosted repositories live under it, private to your company.
- A master account — an administrator user for that organization. This is the account you use to sign in to the Git server, and with it you can manage your repositories and add more users for your team.
- One repository per solver you create as a hosted repo.
You don’t create any of this by hand. It is all set up and managed from the
QCentroid platform, in My organization (/organization/my).
Your Git login is separate from your QCentroid login — on purpose
The username and password you use on the Git server
(git.sandbox.qcentroid.com) are not the same as the email and password
you use to sign in to the QCentroid platform. They are two independent
accounts, by design: keeping them separate means your source-code access and
your platform access stay isolated from each other. You set the Git password
yourself, from the platform (see Access your hosted Git).
What is a hosted repository?#
A hosted repository is a private Git repository that QCentroid creates and hosts on its own Git server. It behaves like any Git repository — you clone it, commit and push your solver’s source code — but QCentroid takes care of creating it and wiring the platform’s access to it.
It comes pre-filled with the minimal solver template files (the
qcentroid.py entrypoint, requirements.txt, etc.), so you can clone it and
start coding straight away.
Not seeing the hosted option?
Hosted repositories are enabled per organization. If you don’t see the options described below, ask your QCentroid administrator to enable the feature for your organization.
Create a hosted repository#
There are two ways to get one:
A. When you add a solver (recommended)
In the last step of How to add a solver, for a Code repository solver, leave the Create a hosted repository checkbox ticked. A hosted repository is created and attached to your solver automatically.
B. From the Repositories section
- Go to Solvers > Repositories and click Connect a new repository.
- In the wizard, open the Hosted tab.
- Click Create hosted repository.
In both cases you are taken to the new repository, already connected and ready to build — no URL and no keys to configure.
Access your hosted Git#
Everything about your hosted Git is managed from My organization
(/organization/my), in the Hosted git card. There you will find:
- The server URL (
https://git.sandbox.qcentroid.com/) and your organization on the Git server. - The username of your master account.
- The number of repositories hosted.
- An Open hosted git button to go to the Git server.
- A Set / reset password button.
The first time, your master account has no password yet, so you have to set
one: click Set / reset password. A new password is generated and shown in
the card — save it somewhere safe (a password manager, for example).
Then sign in at git.sandbox.qcentroid.com with the username shown in the
card and that password.
If you ever lose it, use the same Set / reset password button to generate a new one — it replaces the previous password.
The password is shown only once
The password is displayed a single time in the card, right after you set or reset it, and is never stored by QCentroid. Copy it before you leave or refresh the page. If you miss it, just reset it again.
Add more users for your team#
Your master account is the owner of your organization on the Git server, so once you are signed in there you can add more users and give your teammates access to your repositories. Each person gets their own Git account, independent from their QCentroid platform account (as explained above).
Privacy, ownership and portability#
- Private by default. Your repositories are private to your organization. QCentroid employees have no access to your source code — only the automated build system reads it, to build and run the solvers you create.
- Your code stays yours. You keep full ownership of your source code and all intellectual property in it. Hosting it with QCentroid does not transfer any rights.
- No lock-in. You can move your code to your own Git server (GitHub, GitLab, a self-hosted Gitea/Forgejo…) whenever you want: add your remote and push. Your solvers can then be reconnected to that repository.
Hosted vs. your own repository#
You are free to use either:
- Hosted repository — zero setup, created and managed by QCentroid.
- Your own repository — connect an existing repository on your Git provider over SSH or HTTPS. See Manage your repositories.