Skip to main content

Onboarding Guide

This guide walks you through getting a Drupal project running on Skpr.

Work through the baseline steps first. They're required for a working deployment. The bonus step adds deeper insight once you're up and running.

Baseline​

Complete these four steps to get your project deploying on Skpr.

1. Add Skpr project configuration​

Add a .skpr directory to your project root. This holds the baseline configuration Skpr needs to build and run your site, including:

  • Routing rules
  • Cron tasks
  • Daemons

For a working reference, see the example Drupal project.

2. Make the code changes​

Integrate your Drupal codebase with the Skpr runtime. You'll need to:

  • Wire the site up to the Skpr configuration system
  • Configure filesystem mount paths
  • Set Drupal's trusted host patterns
  • Configure the Drupal's reverse proxy detection
  • Add Drush aliases for the Skpr command line interface (CLI)

Full details are in the Drupal configuration guide.

3. Set up CI/CD​

Skpr works with any continuous integration and continuous delivery (CI/CD) pipeline. We provide ready-to-use examples you can adapt:

4. Configure logging​

Skpr collects logs from standard output (stdout). Install the Skpr Logs module so Drupal prints its logs to stdout for collection.

Bonus points​

Application metrics​

Expose your application's custom metrics for deeper insight into how it's running. See the metrics guide.

Next steps​

When you're ready to launch, follow the go-live guide.