> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/atlas/v2/llms.txt)

# Atlas v2

Current version:`v2.10.0`  
  

-   On-premises vector tile maps
    
-   Offline Mapbox Studio
    
-   Mapbox APIs behind your firewall
    

[Contact us](https://www.mapbox.com/contact/)

![](https://docs.mapbox.com/assets/ideal-img/atlas-header.7be2b7f.480.png)

> **Note (legacy): Upgrade to Atlas v3**
> 
> This guide covers Atlas v2, which continues to be fully supported. Atlas v3 is now available with more flexible deployment options. When you are ready to explore the latest version see our [Atlas v3 guide](https://docs.mapbox.com/atlas/guides).

Mapbox Atlas v2 allows you to run Mapbox global maps on your own infrastructure, including behind a firewall or completely offline. Atlas v2 includes an offline instance of the Mapbox Studio style editor, vector tiles, and has built-in support for custom tilesets. This means that you can run the Mapbox Maps APIs and Studio on a specific server or virtual private cloud that you have complete control over, then deploy to your web, mobile, or AR app.

Atlas v2 supports the latest Mapbox vector map technology, including Mapbox GL JS, so maps render quickly and are highly customizable.

## Atlas v2 license

To install and use Atlas v2, you must have a Mapbox user account with a valid Atlas v2 license. Atlas v2 ships with a single-user account that can be shared concurrently among many users.

Need an Atlas v2 license? [Contact us](mailto:sales@mapbox.com) to learn more.

Your Mapbox Account Manager handles updating your license expiration date whenever you renew with Atlas.

Once your Atlas v2 license is updated, you must update your Atlas v2 installation with the new license key, otherwise Atlas will stop working. You can add the new license key to Atlas by following the instructions in [Atlas for Docker Compose](https://docs.mapbox.com/atlas/v2/guides/docker-compose/#update-your-atlas-license) and [Atlas for Kubernetes](https://docs.mapbox.com/atlas/v2/guides/kubernetes/#renew-license).

## Access token

Once you have added an active Atlas license to your Mapbox user account you will need to create a Mapbox token with `atlas:read` scope within the same Mapbox user account.

1.  Go to the Mapbox [access token page](https://console.mapbox.com/account/access-tokens/).
2.  Click on **+ Create a token**.
3.  Give the new token a name like "Atlas Server".
4.  Uncheck all the default public scopes under **Public scopes**.
5.  Under **Secret scopes**, check the *ATLAS:READ* scope.
6.  Click **Create token**.
7.  Save your new Atlas token in a secure place. Once you leave the Access Tokens page, you will not have access to this token again. Do not commit the Atlas token to GitHub or share it with anyone outside of your organization.

![create a new access token](https://docs.mapbox.com/assets/ideal-img/atlas-secret-access-token.0b16109.480.png)

## System requirements

### Data and disk size

Below are approximate sizes for each dataset. Exact file sizes are subject to change with new data from periodic updates.

| Dataset | Dev | Production | High-Resolution |
| --- | --- | --- | --- |
| Terrain-v2 | 1 GB | 40 GB | 820 GB |
| Streets-v7 | 325 MB | 125 GB | *Not Available* |
| Streets-v8 | 325 MB | 350 GB | *Not Available* |
| Countries-v1 | 1 MB | 1.5 GB | *Not Available* |
| Satellite | 1 GB | 225 GB | 2 TB |
| Terrain-RGB | 1.5 GB | 450 GB | 3.2 TB |
| Boundaries | *Not Available* | 15 GB | *Not Available* |
| Bathymetry-v2 | *Not Available* | 11.2 MB | *Not Available* |
| Search | 5 GB | 75 GB | *Not Available* |
| Navigation | 100 MB | 85 GB | *Not Available* |
| **Total** | **10 GB** | **1.4 TB** | **6.7 TB** |

### Hardware configuration

We recommend, as a minimum, the following hardware configurations for Atlas v2. The *development* configuration is appropriate for testing and evaluating Atlas, and is not recommended for production workloads.

| Development | Production |
| --- | --- |
| 2 CPU | 4 CPU |
| 8 GB RAM | 16 GB RAM |
| 60 GB SSD | 2 TB SSD |

## Get started

Atlas v2 comes in two main flavors — Kubernetes (including OpenShift, EKS, and others) and Docker Compose. See [Atlas for Kubernetes](https://docs.mapbox.com/atlas/v2/guides/kubernetes/) or [Atlas for Docker Compose](https://docs.mapbox.com/atlas/v2/guides/docker-compose/) to get started.