Git Providers
You can use any git provider you want with statichost.eu. If git clone
works,
it will work on statichost.eu. Specific instructions for setting up certain git
providers are given below. Please contact us if
you feel we should add a provider, or if you have questions or comments!
Forgejo (e.g. Codeberg)
Forgejo-based providers, such as Codeberg or CodeFloe.
Private repositories
- Navigate to the repository of your site.
- Go to the
Settings
tab. - Click on the
Deploy keys
sidebar entry. - Click on the
Add deploy key
button. - Paste the provided key under
Content
and optionally choose a name for the deploy key. - Press
Add deploy key
.
Build webhooks
- Navigate to the repository of your site.
- Go to the
Settings
tab. - Click on the
Webhooks
sidebar entry. - Click on the
Add Webhook
button. - Click on the
Forgejo
menu item. - Enter the URL above (with your actual site name) in the Target URL field.
- Select
POST
as the HTTP Method. - Select
application/json
as the POST Content Type. - Select the
Trigger On
Push Events. - Optionally specify a branch filter.
- Click
Add Webhook
.
GitHub
Both GitHub-hosted and on-prem enterprise editions.
Private repositories
- Navigate to the repository of your site.
- Go to the
Settings
tab. - Click
Deploy keys
in the menu. - Click on the
Add deploy key
button. - Choose a name, such as “statichost deployment” and paste in the provided key under
Key
. - Press
Add key
.
Build webhooks
- Navigate to the repository of your site.
- Go to the
Settings
tab. - Click on the
Webhooks
tab. - Click on the
Add webhook
button. - Enter the URL above (with your actual site name) in the payload URL field.
- Select
application/json
as the content type. - Select
Just the push event
. - Press
Add webhook
.
GitLab
Both managed cloud-based and self-managed GitLab.
Build webhooks
- Navigate to your project (repository).
- Got to the
Settings
menu entry. - Click on the
Webhooks
submenu entry. - Click on the
Add new webhook
button. - Enter the URL above (with your actual site name) in the URL field.
- Select the trigger type
Push events
and optionally specify the deployment branch. - Check
SSL verification
. - Click
Add webhook
.
Bitbucket
Both Bitbucket Cloud and Self-Hosted Bitbucket.
Private repositories
- Navigate to your repository on bitbucket.org.
- Go to
Repository settings
. - Under
Security
, selectAccess keys
. - Click the
Add key
button. - Enter a descriptive name (e.g., “statichost deployment”) under
Label
. - Paste the provided key into the
Key
field. - Press
Add key
.
Build webhooks
- Navigate to your repository on bitbucket.org.
- Go to
Repository settings
. - Select
Webhooks
from the sidebar. - Click the
Add webhook
button. - Enter a descriptive title (e.g., “statichost deployment”).
- Enter your statichost.eu webhook URL (see above) in the
URL
field. - Leave
Repository Push
as the only trigger. - Click
Save
.
Azure DevOps
Both Azure DevOps in the cloud and Azure DevOps Server on-prem.
Private repositories
Azure DevOps does not have a “deploy key” concept like many other providers. It is possible to add SSH keys to your user account, and deploy keys can be added here*. Please note, however, that these keys will have full read/write access to all repositories you have access to. Thus, the recommended way to connect to private Azure DevOps is via Personal Access Tokens. Tokens can be limited in scope and can have expiration times.
In order to use a Personal Access Token (PAT) for authentication, you need to select HTTPS as the connection scheme in statichost.eu and add HTTPS authentication details. The username is your Azure DevOps username and the password is the PAT.
In order to create a new Personal Access Token, you can use either one of these methods:
- Navigate to the root your repository. Click
Clone
, selectHTTPS
, and clickGenerate Git Credentials
. - Navigate to
User Settings
->Personal Access Tokens
. Create a new access token with at least theCode: Read
scope for the relevant organization.
*) Azure DevOps only supports RSA keys, while statichost.eu uses ed25519 keys by default. If you need to create an RSA key for your site, please contact support.
Build webhooks
- Navigate to your project.
- Go to
Project settings
(at the bottom of the sidebar). - Select
Service hooks
underGeneral
. - Create a new subscription (plus sign).
- Select the
Web Hooks
service. - Select the
Code pushed
trigger, and add a filter for the repository connected to your site. - Enter your statichost.eu webhook URL (see above) under
URL
. - Click
Finish
.