WPHammer
Log in

Connecting Forge

WPHammer manages WordPress sites that run on servers provisioned by Laravel Forge. Before you can sync servers or manage sites, you need to connect your team's Forge account.

What you need

  • A Laravel Forge account with at least one provisioned server
  • A Forge API token with read and write permissions
  • Your Forge username (the organization or account name shown in Forge)

Generate a Forge API token

  1. Log in to your Forge dashboard at forge.laravel.com.
  2. Navigate to Account → API Tokens.
  3. Enter a descriptive token name — something like WPHammer Production — so you can identify it later.
  4. Click Create and copy the token immediately. Forge will not show it again.

Keep this token secure. It provides full API access to your Forge account.

Add the token in WPHammer

  1. Open your team settings at Settings → Forge.
  2. Paste your API token into the Forge API Key field.
  3. Enter your Forge Username — this is the account or organization name that owns the servers you want to manage.
  4. Save the settings.

WPHammer encrypts your API token at rest. It is never exposed in the UI after saving.

Tag-based server filtering

If your Forge account manages servers for multiple projects or clients, you can limit which servers WPHammer syncs by using Forge Tags. Only servers that carry the specified tags in Forge will be pulled into WPHammer during sync.

To configure tag filtering:

  1. In Forge, assign tags to the servers you want WPHammer to manage.
  2. In WPHammer, go to Settings → Forge and enter the same tag names in the Forge Tags field.
  3. Save. The next sync will only pull servers matching those tags.

If you leave the tags field empty, all servers from the connected Forge account will sync.

Rate limiting

WPHammer respects Forge's API rate limits. Requests are throttled to stay within the allowed window, so large syncs across many servers will complete without hitting errors — they may just take longer.

Next steps

Once your Forge account is connected, you can sync your servers to pull them into WPHammer.

Related