mivama docs
Mivama Docs / hosting

Customer onboarding

Fresh sites, presets and migration choice

Last verified 8 August 2026 · source-backed

A paid subscription must lead to a visible service and guided setup. Provisioning is intentionally held until the customer chooses how the new WordPress site should begin.

Onboarding states

The hosting card shows progress, next action, service hostname and explanations for WordPress, backups, files, Studio and support. The customer should never buy and see an empty dashboard.

Fresh WordPress site

Portal asks for:

  • site title and administration language;
  • timezone, normally Europe/Berlin or UTC;
  • profile: Business, Store, Blog or Blank;
  • optional starter plugins, currently including WooCommerce for Store;
  • confirmation before provisioning.

These are data, not hardcoded shell commands. Core validates the choices and writes them into desired state. Ansible installs WordPress with the requested locale and activates only allowlisted plugins. Optional software should be represented as a versioned catalog/preset so changes are auditable and repeatable.

WooCommerce installation belongs to the runner/Ansible path because it requires filesystem and WordPress CLI access. It is executed as the tenant's WordPress user, never as root inside WordPress.

Migration choice

For migration, Core creates a Mivama Hosting Migration and a one-time access code. Portal downloads a migration connector ZIP customized only with endpoint metadata; the customer uploads the plugin to the source WordPress and enters the code. The source site then authenticates directly to the gateway.

The target tenant may be prepared before import, but Portal reports migration phases instead of pretending the empty WordPress site is finished.

Completion panel

When ready, onboarding displays:

  • live URL and WordPress admin entry;
  • selected language, timezone and installed profile/plugins;
  • SFTP/SSH location without exposing secrets in the page;
  • where backups and restore controls live;
  • how migration cutover works;
  • whether AI Studio is available and why it may require legal activation.

The completion flag is persisted in Frappe so it follows the user and can be reopened as a getting-started guide.