Improve the Installation and Upgrade Process

Objective

To improve the user experience when installing and upgrading Mautic

Due date

May 16, 2021 

Key outcomes

  • Users are prevented from installing or upgrading Mautic in the user interface or command line if their hosting environment could cause problems

  • Improvements to the documentation for installing and updating Mautic in the Documentation and Knowledgebase and in-app

Status

NOT STARTED

Problem Statement

We frequently see people having problems with installing and/or updating Mautic because there are issues with their server resourcing or configuration.

In the Mautic 3 upgrade script we have a pretty comprehensive set of checks that are run to determine whether the environment is suitable, however we do not yet have all of these introduced into the regular install and upgrade process.

We also do not have particularly comprehensive or user friendly documentation for people who are using Mautic for the first time or needing to do common tasks like configuring DNS entries, email providers, installing Mautic in different environments.

Resources

https://github.com/mautic/mautic/issues/8452

Scope

Must have:

Nice to have:

Not in scope:

Initiative Coordinator/s

Contributors

Stakeholder/s

Initiative Coordinator/s

Contributors

Stakeholder/s

Position vacant

 

Product Team (@Ruth Cheesley @Dennis Ameling @Norman Pracht) Education Team (@Ruth Cheesley @Favour Kelvin @Leon-Elias Oltmanns )

Get involved

Timeline

Plan to deploy initial set of improvements in 4.0 (May) - docs can be contributed at any time but ideally should coincide with the 4.0 release at latest.

Milestones and deadlines

Milestone

Owner

Deadline

Status

Milestone

Owner

Deadline

Status

Submit PR adding checks at install and upgrade for review by Core Team

 

Mar 29, 2021

NOT STARTED

Submit articles on installing Mautic in different environments for review by the Education Team

Amazon
Digital Ocean (note: update their article too!)
Linode
Google Cloud

 

May 23, 2021

NOT STARTED

Submit articles on configuring email providers for review by the Education Team

Amazon SES
Elastic Email
Mandrill
Mailjet
Sparkpost
Sendgrid

 

May 23, 2021

NOT STARTED