Stefan Mogeritsch aa157e82f8 docs: add new Access Control and Logs documentation pages

- Documented Access Control features (e.g., Device Approvals, Password Rotation, 2FA, Custom Login Pages).
- Added detailed descriptions for Logs & Analytics (Access Logs, Request Logs, Action Logs).
- Included configuration instructions and feature-specific notes for Pangolin Cloud and Enterprise Edition.

Signed-off-by: Stefan Mogeritsch <stefan.mo.co@gmail.com>

2026-03-11 11:24:24 +01:00

3.5 KiB

Raw Blame History

Documentation Index

Fetch the complete documentation index at: https://docs.pangolin.net/llms.txt Use this file to discover all available pages before exploring further.

How to Update

Keep your Pangolin deployment up to date with the latest features and security patches

Fastest way to get started with Pangolin using the hosted control plane. No credit card required.

Updating Pangolin is straightforward since it's a collection of Docker images. Simply pull the latest images and restart the stack. Migration scripts run automatically to update your database and configuration files when needed.

Before You Update

**Always backup your data before updating.** Copy your `config` directory to a safe location so you can roll back if needed. **Recommended**: Update incrementally between major versions. For example, update from 1.0.0 → 1.1.0 → 1.2.0 instead of jumping directly from 1.0.0 → 1.2.0.

Update Process

Stop all running containers:

```bash  theme={null}
sudo docker compose down
```

Find the latest version numbers:

* **Pangolin**: [GitHub Releases](https://github.com/fosrl/pangolin/releases)
* **Gerbil**: [GitHub Releases](https://github.com/fosrl/gerbil/releases)
* **Traefik**: [Docker Hub](https://hub.docker.com/_/traefik)
* **Badger**: [GitHub Releases](https://github.com/fosrl/badger/releases)

<Info>
  Look for the latest stable release (not pre-release or beta versions).
</Info>

Edit your `docker-compose.yml` file and update the image versions:

```yaml title="docker-compose.yml" theme={null}
services:
  pangolin:
      image: fosrl/pangolin:1.7.3  # Update to latest version
      # ... rest of config

  gerbil:
      image: fosrl/gerbil:1.2.1   # Update to latest version
      # ... rest of config
  
    traefik:
      image: traefik:v3.4.0       # Update if needed
      # ... rest of config
```

Increase the Badger version number in `config/traefik/traefik_config.yml`:

```yaml title="traefik_config.yml" theme={null}
experimental:
  plugins:
    badger:
      moduleName: github.com/fosrl/badger
      version: v1.3.0 # Update to latest version
```

<Warning>
  Update each service you want to upgrade. You can update them individually or all at once.
</Warning>

Download the updated Docker images:

```bash  theme={null}
sudo docker compose pull
```

Start the updated containers:

```bash  theme={null}
sudo docker compose up -d
```

Watch the logs to ensure everything starts correctly:

```bash  theme={null}
sudo docker compose logs -f
```

Test that everything is working:

1. Access your Pangolin dashboard
2. Check that all sites are accessible
3. Verify tunnel connections (if using Gerbil)
4. Test any custom configurations

<Check>
  If everything works, your update is complete!
</Check>

3.5 KiB Raw Blame History

Documentation Index

How to Update

Before You Update

Update Process

3.5 KiB

Raw Blame History