What you need
Launch the instance
- Subscribe to Perfai in AWS Marketplace and choose Launch.
- Choose the instance type, a key pair, a subnet with a public IP, and a security group with the ports above.
- Attach an IAM role to the instance that allows Bedrock access (
bedrock:InvokeModel,bedrock:InvokeModelWithResponseStreamandbedrock:Converse). The appliance uses the instance role, so you do not store AWS keys on the machine. - Set the disk size to 100 GB or more, then launch.
Check progress
Openhttp://<instance address>:9080 for the status page, or sign in over SSH (user ubuntu) and run:
Sign in
By default the appliance uses the address<ip-with-dashes>.sslip.io and a certificate it created itself, so your browser shows a warning until you add your own certificate (next section).
- Open
https://cloud.<your domain>. - Sign in as
admin@perfai.ai. The generated password is theGLOBAL_WEBAPP_ADMIN_PASSWORDvalue in/opt/perfai/lifecycle/config/perfai-secrets.env(readable by root only):
- Change the password when the console asks you to.
Use your own domain and certificate
- Create two DNS records that point to the instance:
<your domain>and*.<your domain>(a wildcard). - Put the domain in
/etc/perfai/appliance.envbefore first start, or switch later with the command below. - Get a certificate that covers
*.<your domain>. A wildcard certificate from a public authority works, and so does one from your own CA. - Load it:
--ca ca.pem. Without it, the services inside the platform cannot trust each other.
Back up
/var/lib/perfai/backups. Copy them off the machine. Take one before every upgrade.
Upgrade without losing data
You choose how to upgrade.- New image and restore (recommended). Launch the new image, copy your data keys and a backup to it, and restore. This also updates the operating system and security hardening. You keep the old machine until you switch your users over, so you can go back at any time.
- Upgrade in place. Install a signed release folder with
sudo perfai-upgrade --release <folder>. The appliance checks the release signature and every file checksum, backs up first, upgrades, and then checks that no database collection lost any documents. If a check fails, it stops and tells you how to put the previous release back. - Automatic upgrade (optional, off by default). Turn it on with
sudo perfai-auto-upgrade --enable. Every night it reads the signed Perfai release feed and installs a newer release only if the signature is valid. It never goes down to an older release.
FIELD_ENCRYPTION_SECRET, SECRET_KEY and IV). A restore refuses to run if the new machine’s keys do not match the backup, so encrypted data is never restored unreadable. Export the keys with sudo perfai-backup --export-secrets <file>. Never put these keys in instance user data.
Get help
Contact Perfai support through your account team, and include the output ofsudo perfai-health --print.
