Skip to content

WordPress Deploy Guide

You can deploy WordPress via Git or File Deploys, both of which will be covered in this guide

Zip Deploys

  • Existing WordPress Sites

    • Take a backup of your site files, or copy from a local folder
    • Move all the files into a folder, with a name of your choice such as wordpress
    • Compress the created folder into a .zip file

  • New WordPress Sites

    • Download the latest version of WordPress here

  • Once you have a .zip file, navigate to the Webslice console in your browser

Git Deploys

  • Existing WordPress Sites
    • If you already have a git repository setup for your WordPress 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 WordPress 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 WordPress 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, just use the files from the latest WordPress zip instead
  • Once you have a git repository setup, navigate to the Webslice console in your browser

All Deploys

  • 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.4 (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 WordPress site files
    • If you downloaded a fresh copy of WordPress, this will be wordpress
  • Hit create and wait for the site to create
  • Once the website is online, navigate to the Databases tab, and click Add New Database
  • Fill in the details as prompted, ensuring that the region is the same as what you selected for the website
    • If you are restoring an existing site, make sure the database name and user match your current setup. You may need to change the database host to localhost in your WordPress config
  • Hit create and wait for the database to be created and linked to your website

Zip Deploys

  • Navigate to the Deploys tab
  • Click the Use File Uploads button, then drag and drop your .zip file containing your site files into the window
  • Hit Upload in the menu that displays, then hit the Upload icon button next to the AVAILABLE icon

Git 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/wordpress-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

All Deploys

  • Wait for the website to deploy your WordPress 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 WordPress setup page, if you are setting up a fresh WordPress site, or at your existing sites homepage!