--- url: https://docs.codefox.ai/self-host/running-fennec.md --- # Running Fennec This page covers what is specific to running Fennec, the CRM, on your server: its parts, its data, and what to watch. ## Where it runs | | | |---|---| | Folder | `/opt/codefox-crm` | | Address | `crm.` | | On the server | `127.0.0.1:3010` (the app) and `127.0.0.1:3011` (its assistant tools, reached at `crm./mcp`) | | Services | `app`, `worker`, `mcp`, `acquisition-worker`, `db`, `migrate`, `updater` | | Smallest size | See [Server sizes](/reference/sizing) | | Settings | [Fennec settings](/reference/settings/fennec) | ## Its data * **Database**: contacts, companies, deals and everything else in the CRM. * **Uploaded files** (`proposals-data`): proposals, partner agreements and the documents written for a client. The database holds only their names, so a backup of the database alone would point at files that are not there. * **The acquisition queue** (`acquisition-spool`): work in progress for the campaigns worker. It is rebuilt from the database and is not backed up. The nightly backup at 01:15 holds the database and the uploaded files, as two encrypted files with the same time in their names. See [Back up and restore](/self-host/backup). ## The secret that must not change Fennec's `APP_SECRET` protects every stored Google connection, every assistant key and connector, and the unsubscribe links in emails already sent. With a different one they all stop working. Keep a copy off the server, and on a new server put it back before you restore Fennec. ## Google, Microsoft and email * Fennec uses the server's Google client for Google sign-in and for each person's Gmail and Calendar, and the Microsoft client for Microsoft 365 sign-in, mail and calendar. Both are set once on **Server** › **Connections**; until then, Gmail, Calendar and Google sign-in are off. * Fennec sends through Resend, or through your own mail server with `SMTP_URL`. See [Set up outgoing email](/self-host/email). * Without Admin, Fennec signs people in by itself: with Google or Microsoft when their client is set. With neither, the hand-over screen says where to find a one-time setup link that makes the first account. ## Quote PDFs A quote's **Download PDF** button appears only where Fennec runs its own PDF renderer, and the install does not turn it on. People can still print a quote from their browser. ## Who manages Fennec's people With Admin on the server, Admin decides who can use Fennec and at which level. A Fennec installed before Admin keeps its own **People** page until you hand its people to Admin. See [Change server settings](/self-host/configure). ## Links to other apps Arctic, Corsac, Pampas, Cape and Culpeo each link to Fennec, and Fennec links to Corsac and Library. The installer wires each link that has both apps on the server; `foxden link` shows them.