PUP
Universal process manager.

This is the source code repository, documentation available at hexagon.github.io/pup.


Pup - The process manager

Pup is a powerful process manager for Deno, designed to simplify the management of your applications and services. Here are some of the key features:

  • Easy process management: Define, control, and manage your processes with simple commands and configuration options.
  • Multiple start policies: Set up processes to start automatically, on a schedule (using cron expressions), or when files change.
  • Restart policies: Configure processes to restart automatically, either always or only in case of errors, with optional delay and restart limits.
  • Clustering and load balancing: Scale your application seamlessly with built-in clustering and load balancing capabilities.
  • Flexible configuration: Define global settings and per-process configurations, including logging, working directories, environment variables, and more.
  • Plugin support: Extend Pup’s functionality with custom plugins for additional features and integrations.
  • CLI and programmatic usage: Manage your processes using the Pup command-line interface, or integrate Pup directly into your Deno applications.
  • Process Telemetry and IPC: Pup can gather telemetry data from Deno client processes, such as memory usage and current working directory, providing deeper insights into managed processes. The telemetry feature also enables inter-process communication, allowing connected processes to interact with one another.

This readme is primarily for the source code and development of Pup, if you’re looking for instructions you should head over to https://hexagon.github.io/pup

Note Programmatic usage, process telemetry, and IPC are currently available only when running Deno client processes.

Quick guide

Install/Upgrade Pup using deno

Before using Pup, you need to have Deno installed on your system. You can download and install Deno with a single command following the instructions provided on the official website: https://deno.land/#installation

With Deno in place, open your terminal and execute the following command to install or upgrade Pup:

deno install -Afr https://deno.land/x/pup/pup.ts

This command downloads the Pup executable and installs it on your system. The A flag grants all permissions, f overwrites any existing installation, and r ensures no cache is used.

Ecosystem example

Use the cli helpers to initialise a new configuration file pup.json

pup --init --id "my-server" --cmd "deno run -A server.ts" --autostart

Add hourly task

pup --append --id "my-task" --cmd "deno run -A task.ts" --cron "0 0 * * * *"

Launch your ecosystem

pup

For the full manual, see https://hexagon.github.io/pup

Example setups

Full examples available at /docs/examples

Contributions and Development

Contributions to Pup are very welcome! Please read the contibuting section of the manual, fork the repository, make your changes, and submit a pull request.

We appreciate all feedback and contributions that help make Pup better!

Examples of areas that need extra attention right now

  • Plugin development: Invent new plugins for Pup, or help out by improving the existing (work in progress) web-interface plugin. See https://hexagon.github.io/pup/examples/plugins/README.html to get started.
  • Testing: Pup needs to be thoroughly tested; help out by using and testing it in various scenarios. Report any issues you find.
  • Reading: Review the documentation and report any issues or areas for improvement.
  • Bugfixes: Find bugs, report them, and optionally create a PR to fix the issue.
  • Spread the word: If you find Pup useful, spread the word to attract more users, developers, and testers to the community. Sharing your experiences and showcasing Pup’s capabilities can help grow and strengthen the project.

Become a Sponsor

The goal of Pup is to be a unique and powerful universal process manager for Deno, and it’s an open-source project. By becoming a sponsor, you’ll help support the development and maintenance of Pup, ensuring that it continues to improve and stay up-to-date with the latest technologies.

Your sponsorship will enable us to:

  • Continue to develop new features and improve existing ones
  • Maintain compatibility with the latest platforms
  • Provide prompt bug fixes and support
  • Create comprehensive documentation and examples for users

If you’re interested in becoming a sponsor, please visit our GitHub Sponsors page. You can also reach out to us directly at hexagon@56k.guru if you have any questions or would like to discuss custom sponsorship options, including getting mentioned in the documentation.