Introduction

This guide provides step-by-step instructions to help you efficiently set up, configure, and manage WordPress projects in a serverless environment. Whether you’re a beginner or an experienced developer, this documentation will walk you through key features, best practices, and advanced functionalities. Start here to learn everything you need to know about leveraging the platform for your projects.

Create a project

Getting started with a new project is quick and straightforward. Follow these steps to create your first project.

1. Log in to your dashboard

   • Navigate to your project dashboard
   • Sign in with your credentials if you haven’t already

2. Initialize a new project

   • Click the “Add Project” button in the top right corner
   • Choose a unique name for your project
   • Choose a PHP runtime version (latest stable version recommended)

3. Review and create

   • Click “Create Project”
   • The dashboard will be displayed
   • Project initialization will begin and the site will be available once complete (usually 2-3 minutes)

Assigning domain names

Once your project has been created, you can assign custom domain names to it by following these steps:

1. Go to your project dashboard

   • Log in to your dashboard and navigate to the Project Settings of the specific project.

2. Add a custom domain

   • In the Domains section, click on Add Domain.
   • Enter the custom domain name you want to assign (e.g., www.example.com).

3. Verify domain ownership

   • To verify ownership, update your DNS settings with your domain registrar:
     • Add a CNAME record pointing your domain to global.agilercdn.net.

Note: DNS changes can take up to 24-48 hours to propagate globally.

Environment variables and secrets

Environment variables and secrets allow you to securely store sensitive information, such as API keys or configuration settings, required for your WordPress application. Here’s how to add and manage them:

1. Navigate to your project dashboard

   • Log in to your dashboard.
   • Select the specific project you want to configure.

2. Go to the Environment Variables section

   • In the Settings menu, locate and click on Variables.
   • You’ll see a list of currently configured variables, if any.

3. Add a new environment variable

   • Provide a name for the variable (e.g., API_KEY, API_URL).
   • Enter the value for the variable.
   • Click the checkmark button to apply changes.

4. Add secrets (for sensitive data)

   • Secrets are used to securely store sensitive data.
   • In the Environment Variables section, Secrets are available below the environment variables section.
   • Provide a name for the secret (e.g., API_SECRET, JWT_SECRET).
   • Enter the secret value.
   • Save the secret to ensure it’s securely stored.

Best Practices:

• Avoid hardcoding sensitive data in your application code.
• Use descriptive names for your environment variables to make them easily identifiable.
• Regularly review and update secrets to maintain security.

Note:

• Environment variables and secrets are project-specific and will not be shared across different projects.
• Secret values cannot be viewed in the dashboard once saved. To change a secret, enter the new value and save again.

Upgrading PHP runtime

It’s important to keep your PHP runtime version up to date to ensure compatibility with the latest features, security updates, and performance improvements. Follow these steps to upgrade the PHP runtime for your project:

1. Access the Project Dashboard

   • Log in to your dashboard.
   • Navigate to the Project Settings of the project you want to upgrade.

2. Open the Settings

   • In the Settings menu, locate and click on the Runtime section.

3. Choose a New PHP Version

   • Select the desired PHP version from the available options.
   • It is recommended to select the latest stable version to avoid compatibility or security issues.

4. Apply Changes

   • Once selected, the system will restart all PHP workers and all requests will begin using the new runtime.

5. Test Your Application

   • After updating the PHP runtime, thoroughly test your application to ensure that all functionality works as expected.
   • Check for any deprecated or removed features that may impact your code.

Best Practices:

• Always review your application code for compatibility with the new PHP version before upgrading.
• Test your WordPress plugins and themes to ensure they are compatible with the updated runtime.
• Regularly monitor the project’s logs for errors after making changes to identify and resolve any issues quickly.

Note: Rolling back to a previous PHP version is possible by changing the runtime on the Settings page.

Configure backups

Backup settings for your project can be managed easily through the Settings page. To ensure your data is protected, follow these steps to configure backups:

1. Navigate to your project dashboard

   • Log in to your dashboard.
   • Select the specific project you want to configure.

2. Go to the Backup Settings section

   • In the Settings menu, locate and click on Backups.

3. Set a backup frequency

   • Choose how often you want backups to be created (e.g., daily, weekly, or monthly).

4. Set a retention period

   • Specify how long you want backups to be retained (up to 1 year).
   • Retention policies ensure older backups are deleted to manage storage efficiently.

Best Practices:

• Regularly review your backup frequency to align with your project’s needs.
• Ensure the retention period balances providing recovery options and managing storage costs.

Note:

• Backup settings are project-specific, and you need to configure them individually for each project.

Restore a backup

You can restore backups on demand directly from your dashboard.

1. Navigate to your project dashboard

   • Log in to your dashboard.
   • Select the specific project you want to restore.

2. Open the Backups page

   • In the Settings menu, click on Backups.

3. Choose a backup to restore

   • In the list of available backups, locate the backup by its date and time.
   • Click Restore for the desired backup.

4. Confirm the restore

   • Review the confirmation prompt and confirm to begin the restoration.
   • The restore process will overwrite the current state of your project with the selected backup.

5. Monitor progress

   • Restoration typically completes within a few minutes.
   • You can track progress in the Backups page and you will be notified when the restoration is complete.

Note: Restoring a backup will overwrite the current state of your project. Ensure you have exported or saved any data you wish to retain before proceeding.

Disable a project

If you want to disable a project, you can do so easily through the project settings. Follow these steps:

1. Navigate to your project dashboard

   • Log in to your dashboard.
   • Select the specific project you wish to disable.

2. Go to the Project Settings

   • In the Settings menu, locate and click on the Status section.

3. Toggle the Active button

   • You will see an Active toggle switch.
   • Set the toggle to Off to disable the project.

Note:

• Disabling a project will prevent it from being accessed or running until it is re-enabled.
• You can re-enable the project by toggling the Active button back to the On position.

Delete a project

To delete a project permanently, follow these steps carefully:

1. Navigate to your project dashboard

   • Log in to your dashboard.
   • Select the specific project you wish to delete.

2. Go to the Project Settings

   • In the Settings menu, locate the Delete Project section at the bottom of the page.

3. Click on the “Delete Project” button

   • The project will be deleted immediately

Note:

• Deleting a project will remove all associated data and resources. Ensure that you have created backups or exported any data you wish to retain.
• Once the project is deleted, it cannot be recovered.