# Quick Start

Get Windshift running in 60 seconds.

## Download

Download the latest release for your platform:

```bash
# Linux (amd64)
curl -L https://windshift.app/download/linux-amd64 -o windshift

# Linux (arm64)
curl -L https://windshift.app/download/linux-arm64 -o windshift

# macOS (Apple Silicon)
curl -L https://windshift.app/download/darwin-arm64 -o windshift

# macOS (Intel)
curl -L https://windshift.app/download/darwin-amd64 -o windshift
```

## Run

Make it executable and run:

```bash
chmod +x windshift
./windshift
```

That's it. Open `http://localhost:8080` in your browser.

## First Login

1. Navigate to `http://localhost:8080`
2. Create your admin account on first visit
3. Start creating workspaces and projects

## Common Options

Run on a different port:

```bash
./windshift -port 3000
```

Specify a database location:

```bash
./windshift -db /path/to/windshift.db
```

Enable HTTPS:

```bash
./windshift -tls-cert cert.pem -tls-key key.pem
```

See [Configuration Options](/docs/configuration/options) for all available options.

## Running as a Service

### systemd (Linux)

Create `/etc/systemd/system/windshift.service`:

```text
[Unit]
Description=Windshift
After=network.target

[Service]
Type=simple
User=windshift
WorkingDirectory=/opt/windshift
ExecStart=/opt/windshift/windshift -db /var/lib/windshift/windshift.db
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
```

Enable and start:

```bash
sudo systemctl enable windshift
sudo systemctl start windshift
```

## Next Steps

- [Configuration Options](/docs/configuration/options) - All CLI flags
- [Reverse Proxy Setup](/docs/configuration/reverse-proxy) - Run behind nginx/Caddy