What is Atlas?

Atlas lets you deploy and run Mapbox APIs on your own infrastructure, whether on your own private cloud or on-premises. Atlas works offline, even in air gapped or classified environments. With Atlas you have full control over the location data and services in your applications.

What can I do with Atlas?

Atlas lets you create an entire custom location platform from start to finish on your own private infrastructure. Style beautiful custom basemaps in Studio then use them with Mapbox GL JS to create beautiful heatmaps or complex data visualizations. Bring business intelligence visualizations on-premises with drop-in support for Power BI, Tableau, MicroStrategy, and Cognos. Create custom tilesets of high resolution satellite imagery with GDAL and use Tippecanoe to transform massive vector datasets into slim mbtiles files. Use Atlas to power your private mobile applications using our Mapbox Maps SDKs for Android and iOS. You can even use Atlas with our Unity SDK to power 3D visualizations using sensitive data.

Why should I use Atlas?

Atlas lets you map, display, and analyze large or sensitive geographic data that needs to stay on-premises or in your own private cloud. Atlas lets you use Mapbox APIs while meeting the security needs or requirements of your organization, including HIPAA, SOC 2, FISMA, ISO, or GDPR. Atlas can also power location services for remote, distributed, or offline systems such as utility operation centers, cruise ships, or field laptops in humanitarian missions.

How does Atlas work?

Atlas uses Docker and Docker Compose to deploy on-premises versions of Mapbox APIs on your infrastructure.

How do I get started with Atlas?

Contact sales to get started with a limited 30 day trial of Atlas.

How do I install Atlas?

You can install Atlas with the Atlas installer command line utility. See the Atlas documentation for detailed instructions on using the installer.

Can I use Atlas on my own private cloud?

Yes! You can install Atlas on your own private cloud, including Amazon Web Services (AWS), Google Cloud Platform (GCP), or Microsoft Azure.

Which operating systems does Atlas support?

• macOS (development use only)
• CentOS 7
• Ubuntu 14.04
• Ubuntu 16.04

What are the hardware requirements for Atlas?

We recommend the following minimum hardware configuration for production Atlas instances:

• 4 CPU cores
• 16 GB RAM
• 600 GB SSD

For testing and development of Atlas we recommend:

• 2 CPU cores
• 8 GB RAM
• 60 GB SSD

How do I upgrade to the latest version of Atlas?

To upgrade your web applications you’ll need to switch from classic styles to GL styles. We recommend switching from Mapbox.js to Mapbox GL JS. Alternatively, you can use L.mapbox.styleLayer in Mapbox.js to load GL styles. Contact Mapbox support (help@mapbox.com) to receive a detailed upgrade and migration guide.

‍

Can I use Mapbox Studio with Atlas?

Yes, Atlas includes an on-premises version of Mapbox Studio.

Which styles are available with Atlas?

• mapbox.dark-v9
• mapbox.dataset-dark-v2
• mapbox.emerald-v8
• mapbox.light-v9
• mapbox.outdoors-v10
• mapbox.satellite-hybrid-v8
• mapbox.satellite-streets-v10
• mapbox.streets-v10

Can I use custom tilesets with Atlas?

Yes! You can use custom tilesets (MBtiles files) in the on-premises version of Studio available in Atlas. You can use Tippecanoe or GDAL to create these tilesets before adding them to your Atlas instance.

Can I use the Mapbox Terrain-RGB tileset with Atlas?

No, at the moment Atlas does not support the Mapbox Terrain-RGB raster tileset.

‍

What is Atlas Search?

Atlas Search enables offline global address level geocoding in an Atlas installation. Turn location text like addresses, cities, and countries into coordinates (forward geocoding) and vice versa (reverse geocoding).

Why should I use Atlas Search?

Add global address level geocoding to offline web, desktop, and mobile applications. Batch forward and reverse geocode large datasets. Quickly search for locations instead of manually panning or zooming. Find locations even with incomplete or misspelled queries using autocomplete and fuzzy search. For example, develop an asset tracking solution on an air gapped network using sensitive sensor data. Geotag content datasets like videos or images to visualize them on the map and drill down to the address level. Or, build a dynamic resource locator to search and display assets based on bounding boxes or proximity to a given address.

Does Atlas Search have the same features as mapbox.com search?

Atlas Search supports the same features as Mapbox.com Search, but completely offline. This includes autocomplete, bounding boxes, fuzzy search, languages, and proximity. However, Atlas Search does not include points of interest (POIs).

What countries are available with Atlas Search?

Atlas Search has the same global coverage as Mapbox.com Search except for Italy, Japan, and Canada.

Does Atlas Search include points of interest (POIs)?

No, Atlas Search does not include points of interest (POIs).

Can I add my own data to Atlas Search?

No, you cannot upload your custom data and query it from Atlas Search.

How often is Atlas Search data updated?

All Atlas Search customers receive complimentary yearly updates upon renewal with the option to purchase quarterly or monthly updates.

How do I purchase Atlas Search?

Atlas customers can purchase Atlas Search for an additional charge. Talk to our sales team to add Atlas Search to your Atlas license.

How do I download Atlas Search updates?

Use the Atlas Installer’s download command to download Atlas Search updates. This command requires internet access. After downloading you can copy the data to your on-premises or offline Atlas installation.

How do I add Atlas Search to my existing Atlas installation?

After buying and downloading Atlas Search, rerun the setup command from the Atlas Installer. This will update your Atlas license and configure Docker containers for Atlas Search.

What are the system requirements for Atlas Search?

Atlas Search uses an additional 70 GB of disk space and 8 GB of RAM. Here are the hardware specifications we recommend for different Atlas environments:

‍

What is Atlas Boundaries?

Atlas Mapbox Boundaries adds administrative, postal, and statistical boundaries to your maps, dashboards, and data visualizations. Atlas Boundaries consists of multiple data layers that come cartographically-matched, georeferenced, and processed as a Mapbox tileset ready for integration with your maps and data.

Why should I use Atlas Boundaries?

Atlas Boundaries facilitates data driven decision making by enabling you to join custom data with global and local boundary polygons. For example:

• A regional disaster response centers can use city and county boundaries to determine jurisdiction for emergency response.
• An Autonomous vehicle company can use administrative boundaries to track mobile asset compliance with varying local, state, and national laws.
• A utility or energy companies can visualize and assess localities affected by transmission infrastructure planning.
• A business intelligence platform can help their customers do any of the above.

Atlas Boundaries lets you visualize your data by country, region, sub-region, or post code to unlock insights within your own application. You can:

• Match point features — any longitude & latitude — to boundaries from our TileQuery API.
• Group statistics about points by boundaries, including easy drill down, with Data-Joins.
• Render an interactive map in your app with GL JS.
• Do any of the above with global coverage.

All of this can happen completely offline.

How do I buy Atlas Boundaries?

Atlas Boundaries is an additional charge on your current Atlas Standard or Enterprise license. Talk to our sales team or your Mapbox sales representative to add Boundaries to your license.

How do I download Atlas Boundaries?

After buying you can use the Atlas installer to download Atlas Boundaries by running the download command.

How do I use Atlas Boundaries?

Follow this getting started guide to begin building maps with Atlas Boundaries.

How do I add Atlas Boundaries to a map style in Atlas Studio?

To add Atlas Boundaries to a map style in Atlas Studio, select the “Add Layer” button and view the “Sources” tab. Next add the tilesets as a layer within a map by selecting specific boundary tilesets from the list of Boundary tilesets. Additional information is covered in the Boundaries getting started guide.

What data is available in Atlas Boundaries?

Atlas Boundaries offers the same data as Boundaries on mapbox.com.

What version of Boundaries comes with Atlas?

Atlas Boundaries uses v2 of Mapbox Boundaries.

What are the system requirements for Atlas Boundaries?

We recommend an additional 8 GB of storage on top of the standard Atlas system requirements. The global Atlas Boundaries data set is 7.01 GB.

How do I upgrade or update Atlas Boundaries data?

To upgrade or update Atlas Boundaries data on an existing Atlas installation you would use the download command in the Atlas installer. The command will download the latest version of Atlas Boundaries. After the download is completed you will have to run the setup command to move the new tilesets into your Atlas instance tileset directory. A detailed guide to this process is available in our documentation.

Which Mapbox APIs come with Atlas?

• Maps API
• Styles API
• Static API
• Tilequery API

Currently only API calls with public access tokens (pk.* tokens) are supported.

Can I use Mapbox GL JS with Atlas?

Yes, you can use Mapbox GL JS with Atlas. To get started, replace mapboxgl.accessToken with an Atlas access token and set mapboxgl.config.API_URL to the URL of your Atlas server.

Can I use Mapbox.js with Atlas?

Yes, you can use Mapbox.js with Atlas. To get started, set L.mapbox.accessToken to an Atlas access token and set L.mapbox.config.HTTPS_URL to the URL of your Atlas server.

Only GL styles with L.mapbox.styleLayer are supported. See Using Your Mapbox Studio styles everywhere. Mapbox Studio Classic styles and legacy styles are not supported.

Can I use Leaflet with Atlas?

Yes, you can use raster tiles served by Atlas with Leaflet.

When adding a L.tileLayer, point it to a style on your local Atlas instance and pass in your token:

L.tileLayer(ATLAS_STYLE_URL + 'tiles/{z}/{x}/{y}?access_token=' + YOUR_ACCESS_TOKEN).addTo(map);

Note that Leaflet only supports raster tiles, so this will be fetching raster tiles from Atlas, not vector tiles. See here for a more thorough example.

Can I use the Maps SDK for iOS with Atlas?

Yes, you can use the Maps SDK for iOS with Atlas.

Can I use the Maps SDK for Qt with Atlas?

Yes, you can use the Maps SDK for Qt with Atlas.

Can I use the Maps SDK for Unity with Atlas?

Yes, you can use the Maps SDK for Unity with Atlas.

Which versions of Mapbox GL JS and Mapbox.js are available with Atlas?

• Versions 0.40 through 0.52 of Mapbox GL JS
• Versions 2.0 through 3.1 of Mapbox.js

‍

What data is available with Atlas?

All Atlas installations come with the following complimentary datasets:

• Mapbox Streets v7 (up to zoom level 15)
• Mapbox Terrain v2 (up to zoom level 12)
• Mapbox Satellite (up to zoom level 12)

Higher zoom levels and other data sets are available. Contact sales for more information.

What are the file sizes for each tileset?

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

How often do you update Atlas data?

All Atlas installations come with complimentary yearly updates of our Mapbox Streets data set. If you want more frequent updates (weekly, monthly, or quarterly), please contact sales.

Can I use high resolution satellite imagery with Atlas?

Yes! Contact sales if you’d like to purchase high resolution satellite imagery for Atlas.

‍

What access tokens do I use with Atlas?

Atlas uses a local public access token that is unique to your Atlas installation. You can use this token to build with Mapbox GL JS and serve your Atlas maps on your infrastructure.

Does Atlas support secret access tokens?

No, at this time Atlas does not support secret access tokens (sk.*).

Can I use Mapbox.com access tokens with Atlas?

No, you cannot use Mapbox.com access tokens with your Atlas installation. You can only use local Atlas access tokens with your Atlas installation.

Does Atlas support HTTPS?

Yes, Atlas GL supports HTTPS natively without needing to configure a separate proxy server. You can use your own TLS certificates with Atlas. Atlas will also generate temporary self-signed certificates for testing and development purposes only.

How many user accounts are available with Atlas?

At the moment Atlas only supports one user account (atlas-user). Multiple user accounts are currently on our roadmap.

Can I change the password for the Atlas user?

Yes, we recommend that you use the settings command in the Atlas installer to change the default password for the Atlas user account.

Can I change the port and hostname of my Atlas server?

Yes, you can use the settings command in the Atlas installer to change the hostname and port of your Atlas server.

‍