Skip to content

Commit 0f1a8e6

Browse files
committed
update readme
1 parent 05ee28d commit 0f1a8e6

File tree

1 file changed

+26
-25
lines changed

1 file changed

+26
-25
lines changed

readme.md

Lines changed: 26 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,53 @@
11
# Dokploy Deployment GitHub Action
22

3-
This GitHub Action triggers a deployment on Dokploy.
3+
This GitHub Action triggers a deployment on Dokploy using the latest API format.
44

5-
## Inputs
6-
7-
### `auth_token`
5+
> **Note**: This is an updated fork of the original `benbristow/dokploy-deploy-action` which is outdated and uses deprecated authentication methods. This version uses the current Dokploy API with `x-api-key` authentication.
86
9-
**Required** The Dokploy API key (used as x-api-key header).
7+
## Inputs
108

11-
### `application_id`
9+
| Input | Description | Required | Example |
10+
|-------|-------------|----------|---------|
11+
| `dokploy_url` | Dokploy dashboard URL (no trailing slash) || `https://dokploy.example.com` |
12+
| `auth_token` | Dokploy API key || `your-api-key-here` |
13+
| `application_id` | Dokploy application ID || `app-123456` |
1214

13-
**Required** The Dokploy application ID.
15+
## Setup
1416

15-
### `dokploy_url`
17+
1. [**Get your Dokploy API Key**](https://docs.dokploy.com/docs/core/auto-deploy#steps-to-deploy-using-api)
1618

17-
**Required** Dokploy dashboard URL (this should have the Dokploy API accessible at /api) - no trailing backslash.
19+
2. [**Find your Application ID**](https://docs.dokploy.com/docs/core/auto-deploy#steps-to-deploy-using-api)
1820

19-
e.g. `https://server.example.com`
21+
3. **Set up GitHub Secrets**:
22+
- Go to your repository → Settings → Secrets and variables → Actions
23+
- Add the following secrets:
24+
- `DOKPLOY_URL`: Your Dokploy instance URL
25+
- `DOKPLOY_API_KEY`: Your API key from step 1
26+
- `DOKPLOY_APPLICATION_ID`: Your application ID from step 2
2027

2128
## Usage
2229

23-
To use this action, include it in your workflow file as follows:
30+
Add this action to your workflow file (e.g., `.github/workflows/deploy.yml`):
2431

2532
```yaml
26-
name: Dokploy Deployment Workflow
33+
name: Deploy to Dokploy
2734

28-
on: [push]
35+
on:
36+
push:
37+
branches: [ main ] # Deploy on push to main branch
2938

3039
jobs:
3140
deploy:
3241
runs-on: ubuntu-latest
42+
3343
steps:
3444
- name: Checkout code
3545
uses: actions/checkout@v4
3646

37-
- name: Dokploy Deployment
47+
- name: Deploy to Dokploy
3848
uses: ahmedabdou14/dokploy-deploy-action@v1.0.0
3949
with:
50+
dokploy_url: ${{ secrets.DOKPLOY_URL }}
4051
auth_token: ${{ secrets.DOKPLOY_API_KEY }}
4152
application_id: ${{ secrets.DOKPLOY_APPLICATION_ID }}
42-
dokploy_url: ${{ secrets.DOKPLOY_URL }}
43-
```
44-
45-
## Contributing
46-
47-
Contributions are welcome! Please feel free to submit a pull request or open an issue for any bugs or feature requests.
48-
49-
50-
## License
51-
52-
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
53+
```

0 commit comments

Comments
 (0)