This GitHub Action triggers a deployment on your Dokploy instance as part of a CI/CD pipeline.

The Dokploy authentication token.
You can generate this under your Dokploy profile by clicking Generate API Key.

The ID of your application in Dokploy.
You can find this in the URL of your application.
Example:
If your application is located at https://dokploy.example.com/dashboard/project/.../services/application/hdoihUG0FmYC8GdoFEc,
then your application ID is hdoihUG0FmYC8GdoFEc.

The base URL of your Dokploy instance, without a trailing slash.
Example: https://dokploy.example.com

Optional Type of Dokploy service (compose or application)

Default application

Include this action in your GitHub workflow file like this:

name: Dokploy Deployment Workflow

on: [push]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Dokploy Deployment
      uses: benbristow/dokploy-deploy-action@0.2.2
      with:
        api_token: ${{ secrets.DOKPLOY_AUTH_TOKEN }}
        application_id: ${{ secrets.DOKPLOY_APPLICATION_ID }}
        dokploy_url: ${{ secrets.DOKPLOY_URL }}
        service_type: application

Note: If you encounter persistent 403 errors, it might be related to Cloudflare bot detection blocking the requests, so it’s worth checking on that separately.

Contributions are welcome! Please feel free to submit a pull request or open an issue for any bugs or feature requests.

This project is licensed under the MIT License. See the LICENSE file for details.