Skip to main content

Deploy Plausible Analytics

Plausible is a privacy-focused web analytics platform with a compact dashboard and cookie-free event collection. Moltern deploys Plausible Community Edition with managed PostgreSQL and ClickHouse dependencies.

What Moltern deploys​

ComponentPurposeAccess
Plausible Community Edition 3.2Account, site dashboard and event collectorPublic HTTPS URL with Plausible sign-in
Managed PostgreSQLAccounts, sites and configurationPrivate to the selected environment
Managed ClickHousePage views, events and analytics queriesPrivate to the selected environment

The Plausible runtime is stateless. Both databases use isolated paths in the team workspace and are provisioned before Plausible starts.

Deploy Plausible​

  1. Open Services and choose Plausible.
  2. Select the project and environment.
  3. Enter a service name.
  4. Review the three-workload install impact.
  5. Choose Deploy service and wait until Plausible reports Running.

Plausible Analytics deployment form in Moltern

Plausible install preview with managed PostgreSQL and ClickHouse dependencies

Create an account and site​

Open the generated URL:

  1. Enter the first owner's name, email and a strong password.
  2. Create the account.
  3. Enter the website domain without a path.
  4. Select the reporting timezone.
  5. Choose Install Plausible.

Use a domain that exactly matches the hostname sent by the tracking script. Protocol and path are not part of the site domain.

Configure email delivery​

Plausible starts in local email mode, so account and site creation do not fail when an external mail provider has not been connected. Configure delivery before you rely on password reset, invitations or scheduled analytics reports:

  1. Open the Plausible service in Moltern and choose Settings.
  2. Add MAILER_ADAPTER=Bamboo.Mua and a verified MAILER_EMAIL sender.
  3. Add SMTP_HOST_ADDR, SMTP_HOST_PORT, SMTP_USER_NAME and SMTP_USER_PWD for your provider. Store the password as a sensitive value.
  4. Add SMTP_HOST_SSL_ENABLED=true when the provider requires implicit TLS.
  5. Save the variables and restart Plausible, then test a password-reset email.

Use the adapter and connection settings required by your provider. Do not place SMTP credentials in site tracking code, screenshots or application repositories.

Install tracking​

Copy the script shown during onboarding into the HTML <head> of the website:

<script
defer
data-domain="analytics.example.com"
src="https://your-plausible-domain/js/script.js">
</script>

Replace both example domains. After loading a page, open the Plausible dashboard and confirm that at least one visitor and the expected path are visible.

Plausible site dashboard with a retained page view after restart

Browser privacy extensions can block analytics scripts even when your service is healthy. Verify with a clean browser profile or a controlled server-side event when troubleshooting.

Restart and persistence​

Stopping and starting Plausible replaces only its stateless runtime. The owner, site configuration and page views remain in managed PostgreSQL and ClickHouse. The same site dashboard must reopen after the service returns to Running.

Storage and metering​

Moltern records Plausible, PostgreSQL and ClickHouse as separate workloads. Billing shows CPU, memory, replicas and measured workspace usage for each. There is no hidden Plausible volume and no database is exposed through a public route.

Delete Plausible​

Choose Delete Service, select the option to remove stored data and confirm the protected action. Moltern removes Plausible, both auto-provisioned database dependencies, all three usage allocations, credentials, routes and assigned workspace paths.

Troubleshooting​

SymptomWhat to check
Registration returns an application errorConfirm PostgreSQL and ClickHouse are Running and review Plausible Live Logs.
Events are accepted but the dashboard is emptyVerify the site domain, request hostname, selected date and browser privacy extension.
Password reset or reports do not arriveConfirm an external mail provider is configured, the sender is verified and the provider accepts the selected TLS mode.
Plausible remains DeployingCheck dependency progress first; both databases must be ready before the application starts.
The site is missing after restartConfirm the original managed PostgreSQL and ClickHouse dependencies are still attached.
A database URL is publicRemove the route and contact support; managed dependencies should be private.

Upstream resources​