> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v2.ard.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlas

> Authentication service for managing weather personnel by email

## Overview

Atlas is an authentication service that manages authorization by email and sends tokens. It is used to register weather personnel and provides authentication for other services like Overrider Panel.

## Repository

**Repository:** [https://git.wthr.ws/weathertech/atlas](https://git.wthr.ws/weathertech/atlas)

Clone the repository:

```bash theme={null}
git clone https://git.wthr.ws/weathertech/atlas
cd atlas
```

## Database Configuration

To register weather personnel, configure the database settings in:

**Database file:** [source/aw/atlas/database.d](https://git.wthr.ws/weathertech/atlas/-/blob/master/source/aw/atlas/database.d?ref_type=heads)

## Deployment

Atlas is deployed via **Portainer** on Docker Swarm.

### Deployment Location

**Portainer Stack:** [wt-atlas-api](https://portainer.devops.arabiaweather.com/#!/2/docker/stacks/wt-atlas-api?id=279\&type=1\&regular=true\&orphaned=false\&orphanedRunning=false)

### Deployment Process

<Warning>
  Atlas has **no CI/CD pipeline**. All deployments must be done manually.
</Warning>

To deploy a new version:

1. **Make code changes** in the repository
2. **Commit** your changes:
   ```bash theme={null}
   git add .
   git commit -m "Your commit message"
   ```
3. **Push** to the repository:
   ```bash theme={null}
   git push
   ```
4. **Tag** the release (tag name template: `vYYYY.MM.DD-X`):
   ```bash theme={null}
   git tag v2025.08.05-1
   git push --tags
   ```
5. **Build** the Docker image:
   ```bash theme={null}
   docker build -f Docker/Dockerfile -t registry.docker.devops.arabiaweather.com/atlas:v2025.08.05-1 .
   ```
6. **Push** the image to the registry:
   ```bash theme={null}
   docker push registry.docker.devops.arabiaweather.com/atlas:v2025.08.05-1
   ```
7. **Update the stack** in Portainer:
   * Navigate to the `wt-atlas-api` stack
   * Update the `image` field to the new tag
   * Redeploy the stack

### Image Tag Format

The image tag follows the format: `registry.docker.devops.arabiaweather.com/atlas:vYYYY.MM.DD-X`

Example: `registry.docker.devops.arabiaweather.com/atlas:v2025.08.05-1`

## Usage

Atlas provides authentication services for other tools in the Legacy Met Tools suite, particularly the Overrider Panel. It manages user authentication via email and token-based authorization.