Skip to main content

Portainer controller

Install

This project is published to PyPi and you can install it using pip:

pip install portainer-ctl

You can also use the published container images:

docker pull hnaderi/pctl
# or
docker pull ghcr.io/hnaderi/pctl

Features

  • Fully automated deployment
  • Support for multiple config and secret
  • Support for .env files and multiple variables
  • Support for api tokens introduced in portainer 2.11.0

Usage

Usage: pctl [-h] [-T API_TOKEN] [-H HOST] [-U USERNAME] [-P PASSWORD] [--debug] [-j] {deploy,stacks,configs,secrets,endpoints,tags,system} ...

Poorman's kubectl, CLI for portainer on docker swarm

Options:
  -h, --help            show this help message and exit
  -T, --api-token API_TOKEN
                        api token for user, overrides PORTAINER_TOKEN variable (default: None)
  -H, --host HOST       portainer host, overrides PORTAINER_HOST variable (default: http://127.0.0.1:9000/api)
  -U, --username USERNAME
                        username to login, overrides PORTAINER_USERNAME variable (default: admin)
  -P, --password PASSWORD
                        password for user, overrides PORTAINER_PASSWORD variable (default: admin)
  --debug               Whether or not print debugging logs (default: False)
  -j, --json            Print json output (default: False)

Commands:
  {deploy,stacks,configs,secrets,endpoints,tags,system}

No budget. No vendors. No fleet of ops. Just you, a blinking cursor, and the will to script what others buy. The rich scale with dollars. You scale with shell. Excuses cost, Automation pays!

You can provide host, username and password in environment:

  • PORTAINER_HOST
  • PORTAINER_USERNAME
  • PORTAINER_PASSWORD
  • PORTAINER_TOKEN

Release files for portainer-ctl 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for portainer-ctl 0.2.2
File Size Uploaded
portainer_ctl-0.2.2.tar.gz 35.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for portainer-ctl 0.2.2
File Interpreter ABI Platform
portainer_ctl-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 50.3 kB

Release files / portainer_ctl-0.2.2.tar.gz

Download URL portainer_ctl-0.2.2.tar.gz
Size 35.3 kB
Tags Source
SHA-256 checksum
How to use checksums
364405e5ead9e6fd1591dac52e76ab587b2cf80dfb0a44923483dacaf70bf5a8
BLAKE2b-256 checksum
How to use checksums
61d0f552be9dd3d4158129eb7fb1119be769efda3c3e5c290f60125ae424f0a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 10, 2026.

Transparency log

Release files / portainer_ctl-0.2.2-py3-none-any.whl

Download URL portainer_ctl-0.2.2-py3-none-any.whl
Size 15.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
617a4422fe9a6f298e2d978ea6199428f3b7849232e6041342d667993c23a153
BLAKE2b-256 checksum
How to use checksums
149f550e5f0fbd75cd88fe37ca971a980829513633c8236534e1304fe560a3bc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 10, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page