PyRunner

Documentation

Getting Started

Run and schedule Python scripts from your browser. One container, no setup headaches.

1 Install with Docker

Run this command to start PyRunner:

docker run -d \
  --name pyrunner \
  -p 8000:8000 \
  -v pyrunner_data:/app/data \
  hasanaboulhasan/pyrunner:latest

Open http://localhost:8000 and create your account.

2 Install with Coolify

Prefer the guided setup? The Install PyRunner on Coolify (3-Minute Setup) guide uses Coolify's Docker Compose path with a pre-tuned compose file — persistent volume, healthcheck, port, and automatic HTTPS are all wired up for you. The quick steps below are the minimal Docker Image path.
  1. Go to your project and click + Add New Resource
  2. Select Docker Image
  3. Enter the image name:
hasanaboulhasan/pyrunner:latest
  1. Set port to 8000
  2. Add environment variables:
ALLOWED_HOSTS=your-domain.com
DEBUG=False
  1. Add persistent storage: /app/data
  2. Click Deploy

3 First Login

Open PyRunner in your browser. The setup wizard will guide you to create your admin account.

Once logged in, you can start creating and running Python scripts right away.

Next Steps

Scripts

Create and manage your Python scripts.

Scheduling

Run scripts automatically at intervals or on cron.

Environments

Add custom pip packages for your scripts.

Secrets

Store API keys and sensitive data securely.