mirror of
https://github.com/Dokploy/website
synced 2025-06-26 18:16:01 +00:00
feat: migration to fumadocs 14
This commit is contained in:
Mauricio Siu
73
apps/docs-v2/content/docs/core/(Git-Sources)/bitbucket.mdx
Normal file
73
apps/docs-v2/content/docs/core/(Git-Sources)/bitbucket.mdx
Normal file
@@ -0,0 +1,73 @@
|
||||
---
|
||||
title: Bitbucket
|
||||
description: 'Configure your Bitbucket repositories for deployments. This includes setting up access tokens, repository names, and branches.'
|
||||
---
|
||||
|
||||
import { Callout } from 'fumadocs-ui/components/callout';
|
||||
|
||||
Dokploy offer a way to connect your Bitbucket Repository to your Dokploy panel, you can use Groups Names or personal accounts.
|
||||
|
||||
Go to `Git` and select `Bitbucket` as the source, then you can use the following options:
|
||||
|
||||
- **Bitbucket Username**: Set the username that you want to connect to Dokploy.
|
||||
- **App Password**: Set the app password you've created.
|
||||
- **Workspace(Optional)**: Assign a workspace name, this is useful if you want to connect to another workspace.
|
||||
|
||||
Follow the steps to connect your Bitbucket account to Dokploy.
|
||||
|
||||
1. Go to `https://bitbucket.org/account/settings/app-passwords/new` .
|
||||
2. Set Label: eg. `Dokploy-Bitbucket-App`. you can choose any name that you want.
|
||||
3. In permissions make sure to select `Account: Read`, `Workspace membership: Read`, `Projects: Read`
|
||||
, `Repositories: Read` `Pull requests: Read` and `Webhooks: Read and write`.
|
||||
4. Click on `Create`.
|
||||
5. Copy the `App Password` and paste it in Dokploy `Bitbucket` Modal section.
|
||||
6. Set your `Bitbucket Username`.
|
||||
7. (Optional) If you want to use Workspaces, go to `https://bitbucket.org/account/workspaces/`, eg. If you have
|
||||
`dokploy-workspace` copy and paste it in Workspace Name.
|
||||
7. Click on `Configure Bitbucket`.
|
||||
8. If everything is correct, you can update enter to the Update Icon, and click on `Test Connection` to make sure everything is working.
|
||||
9. Now you can use the repositories from your Gitlab Account in `Applications` or `Docker Compose` services.
|
||||
|
||||
<Callout type='warn'>
|
||||
Dokploy doesn't support Bitbucket Automatic deployments on each push you make to your repository.
|
||||
</Callout>
|
||||
|
||||
|
||||
## Setup Automatic Deployments
|
||||
|
||||
You can configure automatic deployments in Dokploy for the Following Services:
|
||||
|
||||
1. **Applications**
|
||||
2. **Docker Compose**
|
||||
|
||||
The steps are the same for both services.
|
||||
|
||||
1. Go to either `Applications` or `Docker Compose` and go to `Deployments` Tab.
|
||||
2. Copy the `Webhook URL`.
|
||||
3. Go to your Bitbucket Account and select the repository.
|
||||
4. In the left menu, select `Repository Settings` and then `Webhooks`.
|
||||
5. Click on `Add Webhook`.
|
||||
6. Set any `Title` and the `URL` to the one you copied in the previous step.
|
||||
7. In the Trigger section, select `Push Events`.
|
||||
8. Click on `Add Webhook`.
|
||||
10. Now you have automatic deployments enabled for the selected repository.
|
||||
|
||||
|
||||
## Clarification on Automatic Deployments
|
||||
|
||||
By default, Dokploy will automatically deploy your application on the Branch you have selected.
|
||||
|
||||
eg. Let's suppose you have a `application` in this way:
|
||||
|
||||
Repository: `my-app`
|
||||
Branch: `feature`
|
||||
|
||||
If you try to make a push on another branch eg. `main`, Dokploy will not automatically deploy your application, because
|
||||
your application have selected `feature` as the Branch.
|
||||
|
||||
<Callout>
|
||||
In the case you want to have multiple applications in the same repository, eg. (development, staging, production), you can create 3 `Applications` in Dokploy
|
||||
and select the branch in each of them.
|
||||
|
||||
This is very usefull if you want to have multiple environments for the same application.
|
||||
</Callout>
|
||||
48
apps/docs-v2/content/docs/core/(Git-Sources)/github.mdx
Normal file
48
apps/docs-v2/content/docs/core/(Git-Sources)/github.mdx
Normal file
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: GitHub
|
||||
description: 'Configure GitHub repositories for deployments. This includes setting up access tokens, repository names, and branches.'
|
||||
---
|
||||
|
||||
import { Callout } from 'fumadocs-ui/components/callout';
|
||||
|
||||
Dokploy offer a way to connect your Github Repository to your Dokploy panel, you can use organizations or personal accounts.
|
||||
|
||||
Go to `Git` and select `Github` as the source, then you can use the following options:
|
||||
|
||||
- **Organization**: Select the organization that you want to connect to Dokploy.
|
||||
- **Personal Account(Default)**: Select the account that you want to connect to Dokploy.
|
||||
|
||||
Follow the steps to connect your Github account to Dokploy.
|
||||
|
||||
1. Click on `Create Github App` to create a new Github App.
|
||||
2. Set Github App Name: eg. `Dokploy-Github-App`. make sure this name is unique.
|
||||
3. Click on `Create Github App`, then you will redirect to the `Git` section of Dokploy.
|
||||
4. Now it will show a `Install` Button, click on it.
|
||||
5. You can select the repositories that you want to dokploy be able to access, you can choose
|
||||
select all repositories or select specific repositories.
|
||||
6. Click on `Install & Authorize` to install the Dokploy App.
|
||||
7. You will be redirected to the `Git` section of Dokploy.
|
||||
8. Now you can use the repositories from your Github Account in `Applications` or `Docker Compose` services.
|
||||
|
||||
<Callout>
|
||||
When you use this method, By default you will have Automatic deployments on each push you make to your repository.
|
||||
</Callout>
|
||||
|
||||
## Clarification on Automatic Deployments
|
||||
|
||||
By default, Dokploy will automatically deploy your application on the Branch you have selected.
|
||||
|
||||
eg. Let's suppose you have a `application` in this way:
|
||||
|
||||
Repository: `my-app`
|
||||
Branch: `feature`
|
||||
|
||||
If you try to make a push on another branch eg. `main`, Dokploy will not automatically deploy your application, because
|
||||
your application have selected `feature` as the Branch.
|
||||
|
||||
<Callout>
|
||||
In the case you want to have multiple applications in the same repository, eg. (development, staging, production), you can create 3 `Applications` in Dokploy
|
||||
and select the branch in each of them.
|
||||
|
||||
This is very usefull if you want to have multiple environments for the same application.
|
||||
</Callout>
|
||||
79
apps/docs-v2/content/docs/core/(Git-Sources)/gitlab.mdx
Normal file
79
apps/docs-v2/content/docs/core/(Git-Sources)/gitlab.mdx
Normal file
@@ -0,0 +1,79 @@
|
||||
---
|
||||
title: Gitlab
|
||||
description: 'Configure Gitlab repositories for deployments. This includes setting up access tokens, repository names, and branches.'
|
||||
---
|
||||
|
||||
|
||||
import { Callout } from 'fumadocs-ui/components/callout';
|
||||
|
||||
Dokploy offer a way to connect your Gitlab Repository to your Dokploy panel, you can use Groups Names or personal accounts.
|
||||
|
||||
|
||||
Go to `Git` and select `Gitlab` as the source, then you can use the following options:
|
||||
|
||||
- **Application ID**: Select the application ID that you want to connect to Dokploy.
|
||||
- **Personal Secret**: Select the secret that you want to connect to Dokploy.
|
||||
- **Group Name(Optional)**: Select the group name that you want to connect to Dokploy(Ideal for Gitlab Groups).
|
||||
|
||||
Follow the steps to connect your Gitlab account to Dokploy.
|
||||
|
||||
1. Go to `https://gitlab.com/-/profile/applications` and click on ` Add New Application`.
|
||||
2. Set Application Name: eg. `Dokploy-Gitlab-App`. choose any name that you want.
|
||||
3. Redirect URI: Copy the `Redirect URI` from Dokploy. eg. `https://dokploy.com/api/providers/gitlab/callback`.
|
||||
4. Select Permissions: `api`, `read_user`, `read_repository`.
|
||||
5. Click on `Save Application`.
|
||||
6. Copy the `Application ID` and `Secret` from Gitlab and paste it in Dokploy `Gitlab` Modal section.
|
||||
7. (Optional) If you want to use Groups, go to `https://gitlab.com/dashboard/groups` enter the group name you
|
||||
want to connect, and look at the URL in the address bar, it will be something like this
|
||||
`https://gitlab.com/dokploy-panel/frontend` you can use Nested Groups and SubGroups and copy the `dokploy-panel/frontend` from Gitlab and paste
|
||||
it in Dokploy `Gitlab` Modal section.
|
||||
8. Click on `Continue`.
|
||||
9. Go Back to Dokploy and click on `Install` button.
|
||||
10. Click on `Authorize`.
|
||||
11. You will be redirected to the `Git` section of Dokploy.
|
||||
12. Now you can use the repositories from your Gitlab Account in `Applications` or `Docker Compose` services.
|
||||
|
||||
<Callout type='warn'>
|
||||
Dokploy doesn't support Gitlab Automatic deployments on each push you make to your repository.
|
||||
</Callout>
|
||||
|
||||
|
||||
## Setup Automatic Deployments
|
||||
|
||||
You can configure automatic deployments in Dokploy for the Following Services:
|
||||
|
||||
1. **Applications**
|
||||
2. **Docker Compose**
|
||||
|
||||
The steps are the same for both services.
|
||||
|
||||
1. Go to either `Applications` or `Docker Compose` and go to `Deployments` Tab.
|
||||
2. Copy the `Webhook URL`.
|
||||
3. Go to your Gitlab Account and select the repository.
|
||||
4. In the left menu, select `Settings` and then `Webhooks`.
|
||||
5. Click on `Add Webhook`.
|
||||
6. Set the `URL` to the one you copied in the previous step.
|
||||
7. In the Trigger section, select `Push Events`.
|
||||
8. Click on `Add Webhook`.
|
||||
9. Click on `Save`.
|
||||
10. Now you have automatic deployments enabled for the selected repository.
|
||||
|
||||
|
||||
## Clarification on Automatic Deployments
|
||||
|
||||
By default, Dokploy will automatically deploy your application on the Branch you have selected.
|
||||
|
||||
eg. Let's suppose you have a `application` in this way:
|
||||
|
||||
Repository: `my-app`
|
||||
Branch: `feature`
|
||||
|
||||
If you try to make a push on another branch eg. `main`, Dokploy will not automatically deploy your application, because
|
||||
your application have selected `feature` as the Branch.
|
||||
|
||||
<Callout>
|
||||
In the case you want to have multiple applications in the same repository, eg. (development, staging, production), you can create 3 `Applications` in Dokploy
|
||||
and select the branch in each of them.
|
||||
|
||||
This is very usefull if you want to have multiple environments for the same application.
|
||||
</Callout>
|
||||
Reference in New Issue
Block a user