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

# Use Atlas with Mapbox Studio

> **Note: Atlas v2 only**
> 
> Offline Mapbox Studio is only supported in [Atlas v2](https://docs.mapbox.com/ja/atlas/v2/). Atlas v3 deployments do not include Studio. Instead, you must author your styles in [Mapbox Studio](https://console.mapbox.com/studio/), export the custom style files, and host them in your Atlas v3 deployment. See the [Atlas v3 map styles guide](https://docs.mapbox.com/ja/atlas/guides/styles/) for instructions.

When Atlas is running, you can log into the Atlas instance of Mapbox Studio with the username `atlas-user` and your configured password. You can build with the provided Mapbox tilesets or your own custom tilesets, as well as use default Mapbox map styles or your own custom styles.

## Create a new style in Studio

With Mapbox Studio, you can create new styles that can be loaded into Atlas. Go to your Studio page (for instance, `https://localhost:2999/studio`). Click **More options** to create a new style. You can use a default Mapbox style as the base for your new map style, or you can upload one.

![Mapbox Studio Styles page](https://docs.mapbox.com/ja/assets/ideal-img/atlas-studio-styles-page.a5a1088.480.png)

If you haven't created a custom map style using Mapbox Studio before, the [Create a custom style tutorial](https://docs.mapbox.com/help/tutorials/create-a-custom-style/) is a good way to learn the interface.

## Available default styles

You can use these default styles out-of-the-box with a client like Mapbox GL JS, or you can customize them in Studio. You can also use the Basic or Monochrome [template styles](https://docs.mapbox.com/studio-manual/guides/map-styling/#template-styles) to create new styles. To start using one of these styles, click the **New style** button, then select the style that you want to use.

-   [mapbox.dark-v10](https://api.mapbox.com/styles/v1/mapbox/dark-v10.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.light-v10](https://api.mapbox.com/styles/v1/mapbox/light-v10.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.streets-v11](https://api.mapbox.com/styles/v1/mapbox/streets-v11.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.outdoors-v11](https://api.mapbox.com/styles/v1/mapbox/outdoors-v11.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.satellite-v9](https://api.mapbox.com/styles/v1/mapbox/satellite-v9.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.satellite-streets-v11](https://api.mapbox.com/styles/v1/mapbox/satellite-streets-v11.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.navigation-day-v1](https://api.mapbox.com/styles/v1/mapbox/navigation-day-v1.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)
-   [mapbox.navigation-night-v1](https://api.mapbox.com/styles/v1/mapbox/navigation-night-v1.html?title=true&access_token=pk.eyJ1IjoiZXhhbXBsZXMiLCJhIjoiY2p1dHRybDR5MGJuZjQzcGhrZ2doeGgwNyJ9.a-vxW4UaxOoUMWUTGnEArw)

## Available Mapbox tilesets

-   [`Mapbox Streets v8`](https://docs.mapbox.com/vector-tiles/reference/mapbox-streets-v8/) has a [maxzoom](https://docs.mapbox.com/style-spec/reference/sources/#vector-maxzoom) of 16.
-   [`Mapbox Terrain v2`](https://docs.mapbox.com/vector-tiles/reference/mapbox-terrain-v2/) has a [maxzoom](https://docs.mapbox.com/style-spec/reference/sources/#vector-maxzoom) of 12.
-   [`Mapbox Satellite`](https://www.mapbox.com/maps/satellite/) has a [maxzoom](https://docs.mapbox.com/style-spec/reference/sources/#raster-maxzoom) of 12.
-   [`Mapbox Terrain RGB`](https://docs.mapbox.com/help/troubleshooting/access-elevation-data/#mapbox-terrain-rgb) has a [maxzoom](https://docs.mapbox.com/style-spec/reference/sources/#raster-maxzoom) of 11.
-   [`Mapbox Countries v1`](https://docs.mapbox.com/vector-tiles/reference/mapbox-countries-v1/) has a [maxzoom](https://docs.mapbox.com/style-spec/reference/sources/#vector-maxzoom) of 12.

Data from tiles at the maxzoom are used when displaying the map at higher zoom levels. As with mapbox.com, client libraries can overzoom beyond the maxzoom level for a tileset to see data up to zoom level 22 (by default).

To take advantage of all features of Mapbox Studio, include Mapbox Streets v8 and Mapbox Countries v1 (which are selected by default) when you install Atlas.

## Create a custom tileset

Atlas supports custom raster and vector tilesets in `.mbtiles` format. You can create your own tilesets using [Tippecanoe](https://github.com/mapbox/tippecanoe), then import them into Atlas.

### Docker Compose

To add a custom tileset to your Atlas installation:

1.  The tileset must be named `atlas-user.<tileset-name>.mbtiles`.
2.  Place the tileset in the `mbtiles/` subdirectory of the Atlas install directory.
3.  Visit the Studio Tilesets page (for example, `https://localhost:2999/studio/tilesets`) to inspect and use your custom tileset.

Correctly named files that are stored in the `mbtiles/` subdirectory will be listed in the Mapbox Studio Tilesets page.

![Mapbox Studio Tilesets page](https://docs.mapbox.com/ja/assets/ideal-img/atlas-studio-tilesets-page.935d0e4.480.png)

You can also use SCP to upload files to a remote server with:

```bash
$ scp path/to/your/custom-tileset.mbtiles your-user@your-server.com:atlas-server/mbtiles/atlas-user.custom-tileset.mbtiles
```

### Kubernetes

To add a custom tileset to your Atlas installation:

1.  The tileset must be named `atlas-user.<tileset-name>.mbtiles`.
2.  Copy your tileset into the atlas-ddb container `kubectl cp atlas-user.<tileset-name>.mbtiles <atlas-backend-pod-name>:/usr/local/src/atlas-ddb/mbtiles -c atlas-ddb`
3.  Visit the Studio Tilesets page (for example, `<your-atlas-url>/studio/tilesets`) to inspect and use your custom tileset.