Install Foxden on one server
This page takes you from an empty Linux server to your first sign-in as the Owner, in the fewest steps. For every choice the installer offers, and for installing from your own computer instead of on the server, read Install Foxden.
Before you start
- A server running Ubuntu or Debian, that you can open a terminal on over SSH as root or as a user who can use
sudo. - Ports 80 and 443 free on the server and reachable from the internet.
- Enough processors, memory and disk for the apps you want. The apps on one server add up; Server sizes lists what each needs, and the installer checks the server before it installs anything.
- A domain you can add DNS records to, such as
yourcompany.com. Each app gets its own name under it, such asadmin.yourcompany.comandcrm.yourcompany.com. - An email address you read. It becomes the Owner's address.
- A public release of Foxden to install. Until the first one is published, the installer asks for an install code; Install Foxden says what that means.
Install
On the server, download and install the
foxdencommand:bashcurl -fsSL https://admin.codefox.ai/cli | bashThe script downloads the latest release, checks it against its published checksum (and its signature, when
cosignis installed), and putsfoxdenin/usr/local/bin.Become root:
bashsudo -iStart the installer on this machine:
bashFOXDEN_LOCAL=1 foxden initFOXDEN_LOCAL=1tellsfoxdenthat this machine is the server. Signed in as root over SSH, you can runfoxden initalone: it asks whether to install here, and you answer yes.At Which products go on this box?, select the apps you want with the space bar, then press Enter. The bars under the list show how much of the server they use. When you pick two or more apps, the installer adds Foxden Admin to them.
Type your domain when the installer asks for the web address.
If your domain does not point at the server yet, the installer shows the record to create where you manage the domain: an
Arecord with the server's address, such as one for*.yourcompany.com. Create it, then choose wait. The installer checks every 10 seconds for up to 10 minutes.Type your email address. You become the Owner, and the address is the contact for the site's security certificates.
When the installer asks whether to add the optional settings now, answer no. You set sign-in, email and AI in Admin on your first day.
Read the review screen, then confirm it. The installer sets up the firewall and Docker, installs the apps, gets their certificates, starts them and schedules their nightly backups.
Sign in as the Owner
When the installer finishes, it shows a hand-over screen.
- Copy the link under Open this link to finish setting up. Keep it private: it signs in whoever opens it, until someone signs in another way. If you lose it,
foxden console linkprints it again. - Copy the secrets and backup passphrase files listed under These cannot be recovered if the box is lost. Escrow them today to a safe place away from the server.
- Open the link in your browser. Admin shows Welcome to your Foxden.
- Select Continue as with your address. You are signed in as the Owner, and Admin opens on Home.
If something is not right
- A web address "did not answer over https": the certificate is not issued yet. Reload the address after a minute. If it stays red, check that the
*.yourcompany.comrecord points at the server and that no firewall in front of the server blocks ports 80 and 443, then runfoxden doctor. - The installer stops before installing: it names the check that failed, such as a port already in use or a server too small for the apps you picked. Fix that and run
foxden initagain. If it stopped after you answered its questions,foxden init --resumecarries on where it stopped.
More fixes are in Troubleshoot your server.
Next
Set up your company on your first day: name your company, choose how people sign in and invite your team.