Build configuration

Prefill build configurations using the setup wizard

When setting up a new project in Deploy Now, you can configure your build process directly in the UI. Deploy Now analyzes your repository for the framework you are using and prefills input fields accordingly. Your build can contain various build steps such as a Node.js, Composer or Bundler. Each build step can contain multiple build commands and build environment variables. Environment variables that are secret are stored in GitHub secrets.

Adapt build configurations for existing projects

The inputs of the project creation process are used to set up an automated workflow based on GitHub Actions. This workflow is defined under .github/workflows/deploy-now.yaml.


New to GitHub Actions? Check their documentation to find out how you can use them to enhance the Deploy Now workflow, e.g. by adding powerful Continuous Integration functionalities. Check the GitHub Actions marketplace for other awesome Actions you can integrate.

Triggering the workflow

The workflow will be triggered by any git commit or certain events in Deploy Now, such as domain connects. You can add custom events to trigger the workflow as described in the GitHub Actions docs.

Fetch project data and checkout project

The first step fetch project data based on the fetch project data Action retrieves meta data from Deploy Now. Afterwards, the checkout step checks out your repository so the workflow can access it.

Install dependencies

Each dependency that is required to run your build steps is installed in a seperate step. You can adapt these steps if you need additional dependencies or want to update the versions of existing ones.

Render templates based on runtime secrets

Render templates passes GitHub secrets that are meant to be used on the runtime to the infrastructure in order to make them accessible in configuration files. More information regarding runtime environment variables can be found under runtime configuration.

Build commands and build environment variables

Afterwards, build commands are executed in the order that was defined in the project set up. Environment variables can be directly inserted under env. If you want a variable to be secret, you can create a new GitHub Secret and reference it via ${{ secrets.KEY_NAME }}. All GitHub secrets starting with IONOS are necessary to exchange information with Deploy Now and should not be deleted.

Deploy results to the runtime

The results of the build steps are deployed to the infrastructure in the deploy build step. More information regarding the deployment can be found under runtime configuration.

Examplary workflow configuration

name: Deploy Now

  - push
  - workflow_dispatch

    runs-on: ubuntu-latest
      - name: Fetch project data
        uses: ionos-deploy-now/retrieve-project-info-action@v1
        id: project
          api-key: ${{ secrets.IONOS_API_KEY }}
          project: ${{ secrets.IONOS_PROJECT_ID }}
      - name: checkout
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        uses: actions/checkout@v2
          submodules: 'recursive'
      - name: Setup composer
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        uses: php-actions/composer@v6
          args: --optimize-autoloader
      - name: Setup Node.js v14.x
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        uses: actions/setup-node@v1
          node-version: 14.x
      - name: Render templates
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        uses: ionos-deploy-now/template-renderer-action@v1
          secrets: |
              host: ${{ secrets.IONOS_MAIL_HOST }}
              port: ${{ secrets.IONOS_MAIL_PORT }}
              user: ${{ secrets.IONOS_MAIL_USERNAME }}
              password: ${{ secrets.IONOS_MAIL_PASSWORD }}
              encryption: ${{ secrets.IONOS_MAIL_ENCRYPTION }}
              fromAddress: ${{ secrets.IONOS_MAIL_FROM_ADDRESS }}
      - name: Prepare project environment
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        run: npm ci
      - name: Build assets and run tests
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        run: npm run prod; php artisan key:generate --force -n; php artisan test;
         CI: true
         SITE_URL: ${{ }}
         EXAMPLE_KEY: value
      - name: Deploy build
        if: ${{ steps.project.outputs.deployment-enabled == 'true' }}
        uses: ionos-deploy-now/deploy-to-ionos-action@v1
          api-key: ${{ secrets.IONOS_API_KEY }}
          branch-id: ${{ steps.project.outputs.branch-id }}
          dist-folder: ./
          project: ${{ secrets.IONOS_PROJECT_ID }}
          runtime-placeholder-files: ${{ steps.template.outputs.runtime-placeholder-files }}

Need help?

Feel free to reach out to us via