How to Deploy Philter in 5 Minutes on the AWS Marketplace
The fastest way to get a self-hosted PII and PHI redaction API running is the AWS Marketplace. You subscribe, launch Philter into your own VPC, and start redacting text. No sales call, no separate contract, and no data leaving your account. From clicking subscribe to your first redacted response is about five minutes.
This guide walks through every step.
Why the Marketplace
Philter is self-hosted on purpose. It runs as an instance inside your own network, you POST text to its API, and you get redacted text back. Nothing is sent to a third party. The AWS Marketplace is the quickest path to that model because it handles three things at once:
- Billing goes through your existing AWS account, so there is no new vendor to onboard. Philter is billed per instance-hour with a 30-day free trial.
- Deployment is a prebuilt, Ubuntu-based AMI, so there is nothing to install or configure on the host.
- Data residency is yours. The instance launches into a VPC and subnet you choose, and the API is reachable only on your network.
Before you start
You need an AWS account with permission to subscribe to Marketplace products and launch EC2 instances, and a VPC with a subnet to launch into (the default VPC is fine for a quick test). That is it.
Step 1: Subscribe to Philter
Open the Philter listing on the AWS Marketplace and choose Continue to Subscribe. Accept the terms. The subscription itself is free; you are billed only for the instance once it is running, and the free trial covers the first 30 days.
Step 2: Configure and launch the instance
After subscribing, choose Continue to Configuration, then Continue to Launch. A few choices matter here:
- Region: launch in the region where your data and applications already live, so traffic to Philter stays local.
- Instance type:
c7i.xlargeis recommended. Smaller types are fine for a quick test. - VPC and subnet: pick the network where the systems that will call Philter run.
- Security group: Philter’s API listens on TCP port
8080, and you reach the instance over SSH on port22. Open both to the specific hosts or CIDR range that need them, not to0.0.0.0/0. - Key pair: select or create one. You need SSH access once, to read Philter’s API key.
Choose Launch, then open the EC2 console and wait for the instance to reach the running state. Note its private IP (or public IP, if you launched it with one).
Step 3: Get your API key
Every instance generates its own encryption key and first API key on its first boot. Connect over SSH and read the API key:
ssh -i my-key.pem ubuntu@PHILTER_IP
sudo grep PHILTER_BOOTSTRAP_API_KEY /opt/philter/.env
The same file holds PHILTER_ENCRYPTION_KEY. Back it up: Philter’s stored data cannot be read without it.
Then, from a host that is allowed through the security group, confirm Philter is running. The health endpoint needs no key:
curl -k https://PHILTER_IP:8080/api/health
A healthy instance returns {"status":"UP","applicationVersion":"4.0.0",...}. Philter serves HTTPS with a self-signed certificate until you replace it, hence -k. If the request hangs or is refused, it is almost always the security group: confirm port 8080 is open from the host you are calling from.
Step 4: Send your first redaction request
Now POST some text to the filter endpoint with your API key:
export PHILTER_API_KEY="sk_..."
curl -k https://PHILTER_IP:8080/api/filter \
-H "Authorization: Bearer $PHILTER_API_KEY" \
-H "Content-Type: text/plain" \
--data-binary "His SSN was 123-45-6789."
Philter returns the redacted text:
His SSN was {{{REDACTED-ssn}}}.
The first request after Philter starts takes a few seconds while it loads its name-detection model. Later requests are fast.
That is a working redaction API in your own account. The {{{REDACTED-ssn}}} placeholder is Philter’s default behavior; you control exactly how each entity type is handled with a redaction policy (redact, mask, encrypt with format-preserving encryption, or pseudonymize). The AWS quick start covers the same steps and adds a key for your application.
From a quick test to production
The five-minute version above is enough to integrate Philter into a pipeline and start sending real text. Before you put it in front of production traffic, two things are worth doing:
- Write a redaction policy. The default redacts names, SSNs, and email addresses, but a policy lets you choose which entity types to detect and how to transform each one. Start with Writing Your First Redaction Policy.
- Replace the self-signed certificate. Philter already serves HTTPS; give it a certificate your clients trust, as in Using a Signed SSL Certificate with Philter, or terminate TLS at a proxy, as in Using an Apache Reverse Proxy with Philter. See Deploying Philter in a HIPAA Environment if you are handling PHI.
When you want the deployment to be repeatable rather than click-through, launch the same AMI from infrastructure as code. Deploying Philter in AWS via a CloudFormation Template shows how to find the AMI ID and launch it as a managed stack, which is the right approach for anything beyond a one-off evaluation.
Not on AWS?
Philter is also on the Google Cloud Marketplace and the Microsoft Azure Marketplace, with the same self-hosted model and per-hour billing in your own cloud account. And if you are redacting text before it reaches a large language model, point the Philter AI Proxy at your new instance so prompts are redacted before they ever leave your network.
You can have a private, auditable redaction API running in your VPC before your coffee gets cold. Launch Philter on the AWS Marketplace to get started.