docs(install): cover Docker and native deployments

This commit is contained in:
Magent release tooling
2026-09-20 17:09:14 +12:00
parent 4aba89c063
commit 76b2b8d879
16 changed files with 1141 additions and 53 deletions
+11 -4
View File
@@ -1,7 +1,13 @@
# Public installation and release guide
Magent runs as one non-root Linux container containing the Python API and the
Next.js frontend. Connect your own media services in the setup wizard; no
Start with [installation methods](INSTALLATION.md): [Docker Compose/CLI](DOCKER.md),
[Portainer](PORTAINER.md), [native Linux services](NATIVE_INSTALL.md), or
[foreground Windows/macOS/Linux](LOCAL_DEVELOPMENT.md). This document retains
the advanced container/manual-key and release-maintenance details.
The container distribution runs as one non-root Linux container containing the
Python API and Next.js frontend; a native deployment runs them as two services.
Connect your own media services in the setup wizard; no
pre-existing Magent account or database is required. Optional
integrations may be skipped. Media files remain in your existing media services.
@@ -22,8 +28,9 @@ relicense third-party software or grant rights to third-party branding.
## Fresh installation
For the simplest **Portainer** installation, use the image-only root
[compose.yml](../compose.yml) and follow the [Portainer guide](PORTAINER.md).
For a prebuilt **Docker Compose or Portainer** installation, use the image-only
root [compose.yml](../compose.yml) and follow the [Docker](DOCKER.md) or
[Portainer](PORTAINER.md) guide.
That fresh-install path pulls `rephl3xnz/magent:latest` from Docker Hub with no
environment inputs, automatically persists its private keys and requires no
Dockerfile or `.env`. Confirm the browser-facing application URL in the