Quick start

Start P-BitM, verify the deployment, and prepare your first authorized campaign.

These steps assume installation and setup are complete.

Use P-BitM only on systems you own or where you have explicit written authorization. Review the authorized-use policy.

1. Start the stack

   python3 p-bitm.py up
   

   Missing images are built automatically. Force a rebuild after source or dependency changes:

   python3 p-bitm.py up --build
   

   Open the configured dashboard URL, which defaults to:

   https://127.0.0.1:8443/
   

   On the first successful start, the CLI displays the initial administrator credentials after confirming that the account was persisted. Change the password after signing in.

   

   A fresh deployment opens on the campaigns list with no campaigns yet.

   
2. Verify the deployment

   python3 p-bitm.py status
   python3 p-bitm.py doctor
   

   Do not prepare a campaign until the required control-plane services are healthy and doctor reports no failures.

3. Prepare campaign resources

   Create and review the reusable resources in this order:

   1. target list;
   2. landing page;
   3. for a Complete campaign, an email template and SMTP profile;
   4. optional plugins and modules;
   5. campaign.

   Choose Complete for a scheduled email-delivery window. Choose Standalone for an immediate, non-scheduled campaign without email or SMTP delivery resources.

   Use only approved test recipients and infrastructure. The campaign guide explains the wizard and lifecycle.

4. Stop the complete runtime

   python3 p-bitm.py down
   

   This is a terminal shutdown: active, paused, and scheduled campaigns are marked completed, and all app-owned campaign, browser, and egress containers are removed. Running up later starts only the control plane; it does not resume those campaigns.