Skip to content

armgit / posta

Public Imported from GitHub
0

Self-hosted email delivery platform that enables applications to send emails via HTTP APIs while handling SMTP delivery, templates, storage, security, and analytics. Fully self-hostable alternative to services like SendGrid or Mailgun.

docs: add Managed Posta on Miabi

Jonas Kaninda0b49087d79ee
diff --git a/README.md b/README.md
index c5849e2..890c849 100644
--- a/README.md
+++ b/README.md
@@ -287,6 +287,19 @@ Posta includes a web dashboard for managing templates, SMTP servers, domains, co
---
+## Managed Posta on Miabi
+
+Posta is available in the **[Miabi Marketplace](https://marketplace.miabi.io/templates/posta)** as a ready-to-run template, deployed with a **dedicated worker** so queued sending, automatic retries, campaigns, and scheduled jobs work from the start.
+
+[![Deploy on Miabi](https://img.shields.io/badge/Deploy%20on-Miabi-7E22CE?style=flat-square)](https://marketplace.miabi.io/templates/posta)
+
+This is still self-hosted Posta — your own instance, your data, the same Apache 2.0 build. You just skip the setup: no Docker Compose to write, no services to wire together. Miabi deploys and manages it for you.
+
+<p align="center">
+ <img src="https://raw.githubusercontent.com/goposta/posta/main/docs/static/img/screenshots/miabi-posta.png" alt="Posta in the Miabi Marketplace" width="900" />
+</p>
+---
+
## Official SDKs
* Go: [https://github.com/goposta/posta-go](https://github.com/goposta/posta-go)
diff --git a/docs/docs/getting-started/installation.md b/docs/docs/getting-started/installation.md
index e869208..6f04c88 100644
--- a/docs/docs/getting-started/installation.md
+++ b/docs/docs/getting-started/installation.md
@@ -8,6 +8,10 @@ description: Deploy Posta with Docker Compose or from source
Posta can be deployed using Docker Compose (recommended) or built from source.
+:::tip Don't want to write Docker Compose?
+Deploy the same self-hosted Posta from the [Miabi Marketplace](https://marketplace.miabi.io/templates/posta) — a ready-to-run template with a dedicated worker, provisioned and managed for you. See [Managed Posta](./managed-posta).
+:::
+
:::tip
Full Docker Compose examples are available in the [`examples/`](https://github.com/goposta/posta/tree/main/examples) folder of the repository.
:::
diff --git a/docs/docs/getting-started/introduction.md b/docs/docs/getting-started/introduction.md
index c7ac35f..c822918 100644
--- a/docs/docs/getting-started/introduction.md
+++ b/docs/docs/getting-started/introduction.md
@@ -70,6 +70,7 @@ Posta is built with:
## Next Steps
+- [Managed Posta](/docs/getting-started/managed-posta) — deploy your own instance from the Miabi Marketplace, no Docker Compose required
- [Installation](/docs/getting-started/installation) — Deploy Posta with Docker or from source
- [Configuration](/docs/getting-started/configuration) — Configure environment variables
- [Quick Start](/docs/getting-started/quickstart) — Send your first email in minutes
diff --git a/docs/docs/getting-started/managed-posta.md b/docs/docs/getting-started/managed-posta.md
new file mode 100644
index 0000000..976c35c
--- /dev/null
+++ b/docs/docs/getting-started/managed-posta.md
@@ -0,0 +1,37 @@
+---
+sidebar_position: 2
+title: Managed Posta
+description: Deploy your own Posta from the Miabi Marketplace, without writing Docker Compose
+---
+
+# Managed Posta on Miabi
+
+Posta is available in the **[Miabi Marketplace](https://marketplace.miabi.io/templates/posta)** as a ready-to-run template, deployed with a **dedicated worker**.
+
+This is still self-hosted Posta — your own instance, your data, the same Apache 2.0 build. What changes is the setup: instead of writing a Docker Compose file, wiring PostgreSQL and Redis, and running a second process for the worker, you deploy from the Marketplace and Miabi provisions and manages it for you.
+
+<div style={{textAlign: 'center', margin: '2rem 0'}}>
+ <a href="https://marketplace.miabi.io/templates/posta" className="button button--primary button--lg">
+ Deploy Posta on Miabi →
+ </a>
+</div>
+
+{/* Screenshot: add the image at docs/static/img/screenshots/miabi-posta.png, then uncomment.
+<p align="center">
+ <img src="/img/screenshots/miabi-posta.png" alt="Posta in the Miabi Marketplace" width="900" />
+</p>
+*/}
+
+## What the template does for you
+
+- **No Docker Compose to write.** The template carries the deployment: the API server, its database and cache, and the environment wiring you would otherwise assemble by hand.
+- **A dedicated worker, included.** Outbound sending is queue-based in Posta, so a separate worker process is what makes queued sending, automatic retries, campaigns, and scheduled jobs work. The template ships it alongside the API server — the same [production topology](./installation#docker-compose--dedicated-worker-production) described below.
+- **Miabi runs the deployment.** Provisioning, running, and managing the infrastructure are handled for you.
+
+## It is still your Posta
+
+Same REST API, same dashboard, same [SDKs](/docs/sdks/overview), same [configuration](./configuration) — everything in these docs applies unchanged. Posta stays open source under Apache 2.0, so nothing about deploying this way locks you in.
+
+## Prefer to wire it up yourself?
+
+Deploy it anywhere Docker or a Go binary runs — see [Installation](./installation) for the Docker Compose examples and build-from-source instructions.
diff --git a/docs/sidebars.ts b/docs/sidebars.ts
index 84923ae..d82f709 100644
--- a/docs/sidebars.ts
+++ b/docs/sidebars.ts
@@ -8,6 +8,7 @@ const sidebars: SidebarsConfig = {
collapsed: false,
items: [
'getting-started/introduction',
+ 'getting-started/managed-posta',
'getting-started/installation',
'getting-started/configuration',
'getting-started/quickstart',
diff --git a/docs/static/img/screenshots/miabi-posta.png b/docs/static/img/screenshots/miabi-posta.png
new file mode 100644
index 0000000..2275fb3
Binary files /dev/null and b/docs/static/img/screenshots/miabi-posta.png differ