Skip to main content

PM3

Like pm2 without node.js.

Installation

Create a virtual environment and install PM3:

python3 -m venv .venv
source .venv/bin/activate
pip install pm3

To upgrade:

pip install -U pm3

Quick start

pm3 daemon start
pm3 ping

Create and manage a process:

pm3 new "/bin/sleep 10" -n sleep10 --autorun
pm3 start sleep10
pm3 stop sleep10
pm3 rm sleep10

Useful commands

pm3 ls
pm3 ls -l
pm3 ls -j
pm3 ps all
pm3 dump all -f dump.json
pm3 load -f dump.json
pm3 log all -f
pm3 err all -n 50
pm3 flush all all
pm3 version

Configuration

Default config file: ~/.pm3/config.ini

[main_section]
pm3_home_dir = /home/user/.pm3
pm3_db = /home/user/.pm3/pm3_db.json
pm3_db_process_table = pm3_procs
main_interpreter = /home/user/venv/bin/python
max_backups = 20
log_max_bytes = 10485760
log_backup_count = 5
log_compress = true

[backend]
name = __backend__
url = http://127.0.0.1:7979/
cmd = /home/user/venv/bin/pm3_backend

[cron_checker]
name = __cron_checker__
cmd = /home/user/venv/bin/pm3_cron_checker
sleep_time = 5
debug = False

Backup and recovery

PM3 creates compressed backups of the TinyDB file before write operations. Backups are stored in ~/.pm3/backups/.

If the database is corrupted at startup, PM3 prints a restore hint. Manual restore example:

gunzip -c ~/.pm3/backups/pm3_db_YYYYMMDD_HHMMSS.json.gz > ~/.pm3/pm3_db.json

Log rotation

Process log files are managed through RotatingFileHandler and can be configured with:

  • log_max_bytes
  • log_backup_count
  • log_compress

When log_compress=true, rotated logs are gzip-compressed.

Release files for PM3 0.5.0

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

Source distribution (sdist)

Source distribution for PM3 0.5.0
File Size Uploaded
pm3-0.5.0.tar.gz 454.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for PM3 0.5.0
File Interpreter ABI Platform
pm3-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 486.6 kB

Release files / pm3-0.5.0.tar.gz

Download URL pm3-0.5.0.tar.gz
Size 454.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ca1bf7fc69720f7c9ebc4ec9ea19b346c60975d9c004597f5a52d82548a7643b
BLAKE2b-256 checksum
How to use checksums
746fdf475ef1e2b71f1296bcb388fc1bf9373085f4bd4f5aae99dbed40791f28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release files / pm3-0.5.0-py3-none-any.whl

Download URL pm3-0.5.0-py3-none-any.whl
Size 32.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a5d264d9d187a14addd063b5de4578888cae64eb30f4ce756fd8acba32076ba7
BLAKE2b-256 checksum
How to use checksums
3febb8fdc4af37380b5a4c0195ae7c118206c9b784a9b818c370109ba51e885c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release history Release notifications | RSS feed

This release

0.5.0 This release

2 release files

0.4.4

1 release file

0.4.2

1 release file

0.4.1

1 release file

0.4.0

1 release file

0.3.29

1 release file

0.3.28

1 release file

0.3.26

1 release file

0.3.25

1 release file

0.3.24

1 release file

0.3.22

2 release files

0.3.21

2 release files

0.3.20

2 release files

0.3.17

2 release files

0.3.16

2 release files

0.3.15

2 release files

0.3.14

2 release files

0.3.13

2 release files

0.3.12

2 release files

0.3.11

2 release files

0.3.10

2 release files

0.3.9

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

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