--- url: https://docs.codefox.ai/self-host/running-pampas.md --- # Running Pampas This page covers what is specific to running Pampas, the forms app, on your server: its data, its captcha keys, its email, and what a restore changes for people who were filling in a form. ## Where it runs | | | |---|---| | Folder | `/opt/pampas` | | Address | `forms.` | | On the server | `127.0.0.1:3410` | | Services | `app`, `worker`, `db`, `migrate`, `updater` | | Settings | [Pampas settings](/reference/settings/pampas) | Pampas answers only at its own address: a request for any other name gets an error (421), except its health address `/api/healthz` and its assistant tools at `/api/mcp`. When you move the domain with `foxden domain set` or Admin, its address moves with it. ## Its data * **Database**: the forms and every answer. * **Uploaded files**: the files and signatures people send with their answers, in Pampas' data folder (`pampas-data`). On a server with Library, the files Pampas stores once it is linked to Library are kept in Library instead. The nightly backup at 01:40 holds the database and the data folder. See [Back up and restore](/self-host/backup). ## Captcha A form can ask for a captcha before it is sent. Pampas needs one provider's keys for it, set once for every form: Cloudflare Turnstile or hCaptcha. **In Admin:** 1. Open **Server** › **Products** and select **Pampas**. 2. Under **Captcha**, select **Set up** (or **Change**). 3. Choose the **Provider**, paste the **Site key** and the **Secret key**, and select **Save and restart**. The keys are checked with the provider before they are saved. **Remove** takes them away. **With the CLI:** set `CAPTCHA_PROVIDER` (`turnstile` or `hcaptcha`), `CAPTCHA_SITE_KEY` and `CAPTCHA_SECRET` together, for example with `foxden config import --product pampas`, then `foxden restart --product pampas`. ## Email Pampas sends no email until email is set up on the server: no notifications, and links are passed on by hand. It sends through Resend, or through your own mail server with `SMTP_URL` and `EMAIL_BACKEND=smtp`. See [Set up outgoing email](/self-host/email). ## After a restore `foxden backup restore` gives Pampas a new `APP_SECRET`, on the same server or a new one. The signed links Pampas already sent to respondents stop working; send them again. ## Sign-in and people With Admin on the server, people sign in to Pampas through Admin. On its own, the hand-over screen prints a setup link (`/setup?token=...`) that creates Pampas' first account; `foxden console link --product pampas` prints it again until that account exists. ## Links to other apps With Fennec on the server, Pampas sends each website form's lead to Fennec. The installer wires the link, and it takes the place of any pairing made in Pampas' own settings.