Portainer

Web interface for managing container environments. Allows you to manage Kubernetes and k3s clusters visually without needing to use kubectl directly.

Version:

2.33.7

back to Marketplace

VM Requisites

Resource Minimun
CPU 2 vCPU
RAM 4 GB
Disk 40 GB
Operating System Ubuntu 22.04 / 24.04

Access Port

Port Protocol Usage
443 HTTPS Portainer web interface

How To Access

With SSL enabled (recommended)

https://<IP-CON-GUIONES>.sslip.io/

Example: if your VM has the IP address 200.25.101.125:

https://200-25-101-125.sslip.io/

Without SSL

http://<IP_DE_LA_VM>/

First time

When you open the URL for the first time, Portainer will prompt you to create an administrator account. You have 5 minutes to complete this step before the setup expires and requires a pod restart.

⚠️ If the account creation screen does not appear or has already expired, restart the pod with:

kubectl rollout restart deployment portainer -n <NAMESPACE>

Verify that Portainer is active

# View the Portainer pod
`kubectl get pods -A | grep portainer`

# View the installation log
`tail -f /var/log/cuemby/bootstrap.log`

Expected output

NAME                         READY   STATUS    RESTARTS
portainer-xxxxxxxxx-xxxxx    1/1     Running   0        ← Running ✓

Configuration Parameters

Parameter Default Description
PORTAINER_DATA_SIZE 10Gi Persistent volume size for Portainer configuration and data.
PORTAINER_SSL_ENABLED true Enable HTTPS with automatic certificate via sslip.io.
PORTAINER_HOSTNAME auto (sslip.io) Custom hostname. If left blank, the URL generated by Cuemby will be used.

ℹ️ Portainer does not require configured credentials upon deployment. The administrator account is created on first login.

First Steps (quick start)

  1. Open the URL and create your administrator account.
  2. Select the local environment to manage the Kubernetes cluster where Portainer is installed.
  3. From the dashboard, you can view and manage namespaces, pods, deployments, services, configmaps, and volumes.
  4. Connect additional environments (other Kubernetes clusters) from Environments → Add environment.

💡 Tip: Portainer connects directly to your local Kubernetes cluster without any additional configuration. It's the ideal starting point for exploring Cuemby Marketplace resources deployed on your VM.

Quick Troubleshooting

Problem Probable cause Solution
Setup screen does not appear Pod still starting Wait ~2 min and reload the page.
Setup expired (timeout 5 min) Registration was not completed on time Restart the pod with kubectl rollout restart deployment portainer -n .
Invalid username or password Incorrect credentials Portainer does not have password recovery by default; restart the pod to reset.
Local environment not connecting Insufficient k3s permits Verify that the Portainer ServiceAccount has access to the cluster.
Pod in CrashLoopBackOff Insufficient resources Check with kubectl describe pod -n .

Cuemby Cloud

IaaS

About Cuemby Cloud

Cuemby Cloud is enterprise-grade cloud infrastructure managed from a single console, built for stronger security, predictable operations, and easy scaling across regions.

Datacenters regions available in Colombia, Ecuador, and Chile

Backed by Tier III / Tier IV data center locations

Zero Network Ingress and Egress Fees

24/7 local expert support

Ready to Modernize Your Enterprise?

Future challenges demand future-ready solutions.
Let’s get started!

© Copyright | Cuemby® 2025