[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"howto:mbtiles:linux:en":3},{"resolvedFromAlias":4,"canonicalExt":5,"ext":5,"name":6,"category":7,"categoryName":8,"updatedAt":9,"os":10,"osLabel":11,"quickSolution":12,"stepByStep":13,"recommendedSoftware":16,"alternativeMethods":17,"commonIssues":18,"securityNote":45,"extensionPath":46,"extensionLabel":47,"breadcrumbs":48,"metaDescription":58},false,"mbtiles","MBTiles (SQLite tile set)","gis","GIS","2026-06-12T08:55:03.182Z","linux","Linux","To open .MBTILES files on Linux, qGIS: Add the .mbtiles file as a Vector Tiles source in QGIS by selecting the local MBTiles database file (file.mbtiles) (for vector MBTiles).",[14,15],"QGIS: Add the .mbtiles file as a Vector Tiles source in QGIS by selecting the local MBTiles database file (file.mbtiles) (for vector MBTiles).","GDAL tools: Use GDAL (e.g., gdalinfo) to inspect/read the MBTiles and, if needed, convert it to another format supported by your workflow.",[],[],[19,26,32,39],{"title":20,"description":21,"steps":22},"Opens but shows a blank map (raster vs vector mismatch)","An MBTiles file can store raster tiles or vector tiles (PBF). If you load a raster MBTiles as a vector tiles source (or vice versa), the application may show nothing or fail to render.",[23,24,25],"Inspect the MBTiles with GDAL (e.g., gdalinfo) or check the MBTiles metadata to determine whether it contains raster tiles or vector tiles.","In QGIS, load it using the appropriate data source type (QGIS vector-tiles workflow is documented for vector MBTiles).","If your target app only supports one type, regenerate/convert tiles in the correct type using your tiling toolchain.",{"title":27,"description":28,"steps":29},"File opens as a database, not a map",".mbtiles is a SQLite database file. If you open it in a generic database browser or SQLite tool, you will see tables (like tiles/metadata) rather than a rendered map.",[30,31],"Open the file in a GIS/map viewer that understands MBTiles (e.g., QGIS for vector tiles).","If you need to verify contents, use a SQLite viewer intentionally and look for the tiles and metadata tables as described in the MBTiles spec.",{"title":33,"description":34,"steps":35},"Corrupt or incomplete tileset (errors reading tiles)","Because MBTiles is a SQLite container, a truncated download/copy or an interrupted write can leave the SQLite database inconsistent, causing read errors or missing tiles.",[36,37,38],"Re-copy or re-download the .mbtiles file to rule out transfer truncation.","Open the database with a SQLite tool to confirm it is readable as a SQLite database and that expected tables exist (per the MBTiles spec).","If you created it yourself, re-export/rebuild the MBTiles from the original data source.",{"title":40,"description":41,"steps":42},"No official MIME type recognized in your environment","Some systems rely on registered IANA media types for content handling. MBTiles may not have an IANA-registered media type, so servers/browsers may treat it as a generic binary download.",[43,44],"Check IANA’s media type registry to confirm whether a registered type exists for your use case.","If none is registered, configure your system to serve it as a generic binary type (e.g., application/octet-stream) or use your platform’s recommended custom mapping for downloads.","An .mbtiles file is a SQLite database; opening untrusted databases in GIS/database tools can still trigger vulnerabilities in parsers (SQLite itself or image/vector tile decoding in the consuming app). Prefer opening untrusted MBTiles in up-to-date software.","/file-extension/mbtiles",".MBTILES",[49,52,55],{"label":50,"to":51},"Home","/",{"label":53,"to":54},"How To","/file-extension",{"label":56,"to":57},"Open .MBTILES on Linux","/how-to/open-mbtiles-on-linux","Learn how to open .MBTILES files on Linux with step-by-step instructions, recommended software, and troubleshooting tips."]