Skip to content

Grav Deploy Guide

You can deploy Grav via Git Deploys.

  • Existing Grav Sites
    • If you already have a git repository setup for your Grav site, you do not need to do anything else at this stage
    • Else, create a new git repository on your preferred git hosting platform
    • Add your Grav site files into the repository, ensuring that the site files are within a singular top level folder. This can be named whatever you like
  • New Grav Sites
    • If you want to start from our provided template, you can fork/clone/copy the repository and work from there
    • Else, follow the above steps for the existing site, using the files from the Grav download page
  • You should not include the vendor folder that composer creates when installing Grav and it’s dependencies, instead create a build script that runs the install command during the deploy. Add the vendor folder to your .gitignore
  • Once you have a git repository setup, navigate to the Webslice console in your browser
  • Select the Project you wish to create your website under
  • Find the + Add button and press it
  • Fill in the details as prompted, ensuring that you pick a PHP version >= 7.3 (or whatever version your existing site runs on, if you are restoring an existing site) and that you set the Document Root to the name of the folder you created which contains your Grav site files
  • Hit create and wait for the site to create
  • If you are using a build script, navigate to the Settings tab, and scroll to the bottom. You can then set the path to the script you wish to run during the deploys
  • Navigate to the Settings tab
  • Scroll down and press the Setup Git Deployments button
  • You will need to find the SSH clone URL for your repository, for the template repository this is git@github.com:webslicehq/grav-demo.git, and input it into the Repository URL input box
  • Generate a deploy key, then add it to your git repository. Your git hosting provider should have instructions on how to add these keys to the repository
  • Once the key has been added, hit Verify Git Access and wait for access to be verified
  • Once verified, you can go through and setup the webhooks to allow for future commits to be deployed for your site. Your git hosting provider should also have instructions for this process
  • Review the other options shown, changing what you need, then hit save
  • Navigate back to the Deploys tab, and the latest commit should be present
  • Hit the Upload icon button next to the AVAILABLE icon
  • Wait for the website to deploy your Grav site, then once the website is Online you can visit the site via the onwebslice.com
    • You can also setup DNS for the onwebslice.com in the Domains tab, but this is not required
  • You should now either be at the Grav setup page, if you are setting up a fresh Grav site, or at your exising sites homepage!