# Installing

> **What you will learn**
> The one-line install command, what it asks you, and what gets installed where.

## One line

Paste into a terminal (macOS/Linux) or PowerShell (Windows).

```bash
# macOS / Linux
curl -fsSL https://hyperteams.net/install.sh | bash
```

```powershell
# Windows PowerShell
iex (irm https://hyperteams.net/install.ps1)
```

**It arrives ready to run.** There is no separate build or assembly step.

## What it asks during the install

### 1. The address

The address you will open in a browser. The default is:

```
http://localhost:27777
```

**Use the default unless you have a reason not to.** If that port is already in
use by another program, it will tell you to change it.

### 2. A password

The password you enter when connecting.

> **It only opens on your own machine right now, but set a password anyway.**
> Once you [connect from outside](/guide/ht-remote-access), that password becomes
> the only door.

If you forget it, [`hyperteams setup`](/guide/ht-cli) lets you set it again.

## What goes where

| | Location |
|---|---|
| Program files | the install folder (shown during install) |
| The command | `hyperteams` — runnable from any folder |
| Database | inside the install folder. **Conversations and usage records** |
| Settings | `.env.local` |
| Logs | `logs/server.log` |

**Nothing is created in your working directories.** HyperTeams only remembers
their paths; it does not put its own files inside them.

## Verifying the install

```bash
hyperteams --version
```

A version number means it is installed.

> **If you get `command not found`**, it is the same as in
> [prerequisites](/guide/ht-prerequisites) — **open a new terminal window** and
> try again.

## Using a different address

If the default port (27777) is taken, you can change it at run time.

```bash
PORT=9000 hyperteams
```

You do not need to reinstall. Specify it each time you run, or change the
default with [`hyperteams setup`](/guide/ht-cli).

## Updating is not reinstalling

**This matters.** When a new version comes out, do not rerun the install script.

```bash
hyperteams upgrade
```

`upgrade` **replaces only the program files.** Records, settings, and any
addresses you connected stay as they are. Reinstalling makes no guarantees about
what happens to them.

## Where people get stuck

### "curl: command not found" (Windows)

On Windows use the PowerShell command. The `curl` version is for macOS and Linux.

### The download is blocked on the corporate network

Possibly a proxy or firewall. Ask IT to allow access to `hyperteams.net`, or
download the install script, inspect it, and then run it.

### It installed but will not run

[The next chapter](/guide/ht-first-run) covers the first run step by step.

---

## Check yourself

**1. What two things does the install ask for?**

<details>
<summary>Answer</summary>

**The address (default `http://localhost:27777`) and a password.** Set the
password even though it only opens locally for now — once you connect from
outside, it becomes the only door.
</details>

**2. Why should you not rerun the install script when a new version arrives?**

<details>
<summary>Answer</summary>

`hyperteams upgrade` **replaces only the program files** and preserves records,
settings, and connected addresses; a reinstall makes no guarantees about them.
</details>

**3. Does HyperTeams create files in your working directories?**

<details>
<summary>Answer</summary>

**No.** It only remembers their paths, and keeps its own files (database,
settings, logs) in the install folder.
</details>

---

Now turn it on → [First run and connecting](/guide/ht-first-run)