Skip to content
listmonk
Documentation

How to install listmonk on VPSnet

Managed install of listmonk from the Applications panel — credentials in-panel, HTTPS included.

Before you start

Prerequisites

Only what you need before the install steps below — nothing repeated from the guide.

  • A VPSnet account with access to the control panel.

  • A VPS or Cloud VPS that meets the listmonk resource guidance on the product page.

Install guide

Install listmonk from the panel

Follow the Applications panel path end to end. Each step covers one action only.

  1. Choose a plan for listmonk

    Open the listmonk product page and note minimum and recommended vCPU, RAM, and disk. Order a new Cloud VPS or VPS, or use a running server that still has free capacity.

    VPSnet server plan selection before application installation
  2. Install from Applications

    In the service panel open Applications → listmonk → Install. Leave VPSnet address selected unless you need another mode under Advanced access. This recipe version exposes no Additional settings or Optional packs. Click Install — defaults are enough. Save any one-time credentials shown after install. If the panel shows an Application runtime setup notice, Install still proceeds — there is no extra checkbox.

    Example Applications install dialog showing access and Additional settings
  3. Save one-time credentials

    When install finishes, the panel shows owner or admin credentials once. Copy them into your password manager immediately — they are never sent by email. If you closed the dialog too early, use the recovery path on that install in Applications.

    Generic illustration of the one-time credentials dialog in Applications
  4. Open the managed HTTPS URL

    When listmonk exposes a web UI, VPSnet assigns a *.vpsnet.cloud hostname. A short Certificate pending state is normal while DNS and SSL finish. When the status is active, use Open URL in Applications.

    Generic illustration of application access and lifecycle controls in Applications
  5. Finish your first task in listmonk

    Sign in with the credentials you saved and complete one useful first task in listmonk (create a project, publish content, or run the primary workflow). This confirms that the application is ready to use.

    listmonk after the first successful sign-in
  6. Operate from the panel

    Use Applications for restart, logs, health, update, and uninstall. Avoid editing the host Compose by hand — catalog installs are version-pinned managed recipes.

    Generic illustration of application access and lifecycle controls in Applications
Install dialog

Options in the install dialog

The Applications → Install dialog is more than a single Install button. These controls appear when the recipe supports them. Safe defaults apply if you leave optional fields unchanged.

  • Application access

    Choose how you reach the app at install time: VPSnet HTTPS (managed *.vpsnet.cloud), Private (this server only), Public IP (cleartext HTTP), Managed HTTPS on a DNS zone you own, or External HTTPS when you terminate SSL. You can change this later on the installation page.

  • Additional settings

    This recipe version exposes no customer-editable Additional settings or Optional packs. Choose Application access and confirm a runtime restart if the panel asks.

  • Runtime restart

    The first managed app on a server may need a short runtime restart. The dialog asks for confirmation. Later installs on the same server usually skip this.

Initial setup

First usage of listmonk

After Open URL, sign in with the secrets you claimed — or finish the in-app admin wizard if this recipe has no panel password. Complete one real job so the install is useful, not only healthy. Optional packs you enabled at install still need their own first-run inside the app.

  • Sign in or create the first admin

    Use the username and password from the one-time Secrets dialog. If this recipe has no panel password, the app shows its own first-run wizard — invent a strong admin password there and store it in a password manager.

  • Finish any in-app setup wizard

    Many apps ask for site name, timezone, language, or a first workspace on first open. Complete that wizard before you invite others. Optional packs (ADDON_/PACK_ flags) are pinned at install — they still need their own first-run screens inside the app.

  • Do one real job, then operate from the panel

    Publish content, create a project, send a test, or run the primary workflow. That confirms the install is useful. Restart, logs, health, update, and uninstall stay in Applications — do not edit host Compose by hand.

Configuration

All configuration variables

This recipe version exposes no customer-editable configuration fields. Generated secrets still appear once in the panel after install when the recipe creates them.

This recipe version exposes no customer-editable configuration fields. Generated secrets still appear once in the panel after install when the recipe creates them.

Access & secrets

How you reach the app and claim secrets

Owner and admin credentials appear once in the VPSnet panel after install — they are never emailed. Most web UIs use managed HTTPS on *.vpsnet.cloud. Choose the access mode in the install dialog, then switch it later from the installation page (private, public HTTP, Managed HTTPS, or advanced External HTTPS when you terminate SSL yourself).

Requirements & compatibility

Sizing and tested targets

VPS and Cloud VPS
RequirementvCPURAMNVMe
Minimum24 GB25 GB
Recommended48 GB50 GB
Server typeOperating systemArchitecture
VPSAlmalinux 10x86_64
VPS and Cloud VPSAlmalinux 9x86_64
VPSCentos stream 10x86_64
VPS and Cloud VPSCentos stream 9x86_64
VPSRocky 10x86_64
VPS and Cloud VPSRocky 9x86_64
VPS and Cloud VPSUbuntu 24.04x86_64
Cloud VPSAlmalinux 8x86_64
Cloud VPSArch latestx86_64
Cloud VPSDebian 11x86_64
Cloud VPSFedora 39x86_64
Cloud VPSFedora 40x86_64
Cloud VPSOpensuse 15.5x86_64
Cloud VPSOracle 9x86_64
Cloud VPSRocky 8x86_64
Cloud VPSUbuntu 20.04x86_64
Troubleshooting

FAQ

01

I closed the credentials dialog without saving the password.

Open that install in Applications and use the recovery path shown there, or contact support if recovery is not offered.

02

Open URL still shows Certificate pending after several minutes.

Confirm the install health is green, then wait for DNS/SSL to finish. If access settings offer temporary public HTTP, you can use it only as a short workaround.

03

I need environment variables that are not in the install form.

Only customer-editable blueprint fields are exposed at install and in the table below. Remaining env belongs to the managed recipe. Custom Compose is a separate advanced option when enabled on the service.