{"id":986,"date":"2023-04-11T22:35:29","date_gmt":"2023-04-11T20:35:29","guid":{"rendered":"https:\/\/osiris.itabc.cnr.it\/aton\/?page_id=986"},"modified":"2023-05-17T20:44:27","modified_gmt":"2023-05-17T18:44:27","slug":"run-deploy-with-docker","status":"publish","type":"page","link":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/","title":{"rendered":"Run & Deploy with Docker"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

This tutorial is a “getting started” to run and deploy ATON framework<\/strong> through Docker<\/a>.<\/p>\n\n\n\n

The prerequisite is indeed you have Docker<\/strong> installed in your machine (generally a server node based on Linux OS). In a Debian Linux environment you can type the following commands from the main ATON folder<\/strong> (if you have Docker installed in a Windows environment, you just need to remove “sudo<\/em>” from the command).<\/p>\n\n\n\n

Quick run<\/h2>\n\n\n\n

The super-quick<\/em> way to deploy ATON framework using Docker in a single command is:<\/p>\n\n\n\n

sudo docker-compose up<\/code><\/pre>\n\n\n\n
This will build, run and deploy ATON framework on local port 8088<\/strong> using a basic configuration, after a fresh install of the framework (e.g. after first clone from github<\/a>). You can find more details and control in the next steps about Docker image, volume (for ATON data) and container.<\/p>\n\n\n\n
Build a Docker image of ATON<\/h2>\n\n\n\n
This step allows to build<\/a> a docker image<\/strong> of the framework using the base Dockerfile <\/em>in the main root folder:<\/p>\n\n\n\n
sudo docker build -t aton .<\/code><\/pre>\n\n\n\n
Once the command has completed all steps, we’ll have our docker image named “aton<\/strong>“. Keep in mind this will create the image starting from the current ATON instance <\/strong>you have configured in your main folder – including current data, users, scenes, etc. So if you launch this command on a fresh ATON instance, the image will contain base setup with samples and default users.<\/p>\n\n\n\n
Note the default Dockerfile <\/em>will create an image shipping all ATON micro-services. You are free to create custom Dockerfiles that suit your needs or specific infrastructures requirements (e.g. multiple containers, etc.). <\/p>\n\n\n\n
Basic deploy<\/h2>\n\n\n\n
Once we built our docker image, we can create and run a new container<\/a> from our “aton” image by typing:<\/p>\n\n\n\n
sudo docker run -dp 8080:8080 aton<\/code><\/pre>\n\n\n\n
This will run the container with the main ATON service exposed on the host’s port 8080<\/strong>. Notice that when the container will be stopped<\/a>, all changes will be lost (e.g. new scenes<\/a>, new users, etc…), since by default all files created inside a container are stored on a writable container layer – see this reference<\/a>. We have different options for containers to store files persistently on the host machine, one is through volumes<\/a><\/em><\/strong>.<\/p>\n\n\n\n
Create a Docker volume for ATON data<\/h2>\n\n\n\n
In order to create a Docker volume for our data folder, we can type:<\/p>\n\n\n\n
sudo docker volume create aton-data<\/code><\/pre>\n\n\n\n
You can inspect the volume, and where is located on your filesystem, by typing:<\/p>\n\n\n\n
sudo docker volume inspect aton-data<\/code><\/pre>\n\n\n\n
which should return something like:<\/p>\n\n\n\n
[\n  {\n  \"CreatedAt\": \"2023-02-27T01:53:53+01:00\",\n  \"Driver\": \"local\",\n  \"Labels\": {},\n  \"Mountpoint\": \"\/var\/snap\/docker\/common\/var-lib-docker\/volumes\/aton-data\/_data\",\n  \"Name\": \"aton-data\",\n  \"Options\": {},\n  \"Scope\": \"local\"\n  }\n]<\/code><\/pre>\n\n\n\n
Run an ATON container with persistent data<\/h2>\n\n\n\n
Now we can run our container mounting our previously created volume, to keep persistent data, by typing:<\/p>\n\n\n\n
sudo docker run -dp 8080:8080 --mount type=volume,src=aton-data,target=\/aton\/data aton<\/code><\/pre>\n\n\n\n
That’s it!<\/strong> You can start\/stop your container without losing changes (published 3D scenes<\/a>, etc.).<\/p>\n\n\n\n
You are free to combine and explore a multitude of setups<\/a> depending on your Docker environment.<\/p>\n","protected":false},"excerpt":{"rendered":"
This tutorial is a “getting started” to run and deploy ATON framework through Docker. The prerequisite is indeed you have Docker installed in your machine (generally a server node based on Linux OS). In a Debian Linux environment you can type the following commands from the main ATON folder (if you have Docker installed in […]<\/p>\n","protected":false},"author":1,"featured_media":1046,"parent":695,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"disabled","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"class_list":["post-986","page","type-page","status-publish","has-post-thumbnail","hentry"],"yoast_head":"\nRun & Deploy with Docker - ATON<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Run & Deploy with Docker - ATON\" \/>\n<meta property=\"og:description\" content=\"This tutorial is a “getting started” to run and deploy ATON framework through Docker. The prerequisite is indeed you have Docker installed in your machine (generally a server node based on Linux OS). In a Debian Linux environment you can type the following commands from the main ATON folder (if you have Docker installed in […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/\" \/>\n<meta property=\"og:site_name\" content=\"ATON\" \/>\n<meta property=\"article:modified_time\" content=\"2023-05-17T18:44:27+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2023\/04\/tut-aton-docker.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1280\" \/>\n\t<meta property=\"og:image:height\" content=\"720\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/\",\"url\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/\",\"name\":\"Run & Deploy with Docker - ATON\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/wp-content\\\/uploads\\\/2023\\\/04\\\/tut-aton-docker.jpg\",\"datePublished\":\"2023-04-11T20:35:29+00:00\",\"dateModified\":\"2023-05-17T18:44:27+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/#primaryimage\",\"url\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/wp-content\\\/uploads\\\/2023\\\/04\\\/tut-aton-docker.jpg\",\"contentUrl\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/wp-content\\\/uploads\\\/2023\\\/04\\\/tut-aton-docker.jpg\",\"width\":1280,\"height\":720},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/run-deploy-with-docker\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tutorials\",\"item\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Getting Started\",\"item\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/index.php\\\/tutorials\\\/getting-started\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Run & Deploy with Docker\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/#website\",\"url\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/\",\"name\":\"ATON\",\"description\":\"open-source Web3D\\\/WebXR framework by CNR ISPC\",\"publisher\":{\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/#organization\",\"name\":\"ATON\",\"url\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/wp-content\\\/uploads\\\/2022\\\/12\\\/aton-logo-100.png\",\"contentUrl\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/wp-content\\\/uploads\\\/2022\\\/12\\\/aton-logo-100.png\",\"width\":100,\"height\":100,\"caption\":\"ATON\"},\"image\":{\"@id\":\"https:\\\/\\\/osiris.itabc.cnr.it\\\/aton\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Run & Deploy with Docker - ATON","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/","og_locale":"en_US","og_type":"article","og_title":"Run & Deploy with Docker - ATON","og_description":"This tutorial is a “getting started” to run and deploy ATON framework through Docker. The prerequisite is indeed you have Docker installed in your machine (generally a server node based on Linux OS). In a Debian Linux environment you can type the following commands from the main ATON folder (if you have Docker installed in […]","og_url":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/","og_site_name":"ATON","article_modified_time":"2023-05-17T18:44:27+00:00","og_image":[{"width":1280,"height":720,"url":"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2023\/04\/tut-aton-docker.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/","url":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/","name":"Run & Deploy with Docker - ATON","isPartOf":{"@id":"https:\/\/osiris.itabc.cnr.it\/aton\/#website"},"primaryImageOfPage":{"@id":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/#primaryimage"},"image":{"@id":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/#primaryimage"},"thumbnailUrl":"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2023\/04\/tut-aton-docker.jpg","datePublished":"2023-04-11T20:35:29+00:00","dateModified":"2023-05-17T18:44:27+00:00","breadcrumb":{"@id":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/#primaryimage","url":"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2023\/04\/tut-aton-docker.jpg","contentUrl":"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2023\/04\/tut-aton-docker.jpg","width":1280,"height":720},{"@type":"BreadcrumbList","@id":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/run-deploy-with-docker\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/osiris.itabc.cnr.it\/aton\/"},{"@type":"ListItem","position":2,"name":"Tutorials","item":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/"},{"@type":"ListItem","position":3,"name":"Getting Started","item":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/tutorials\/getting-started\/"},{"@type":"ListItem","position":4,"name":"Run & Deploy with Docker"}]},{"@type":"WebSite","@id":"https:\/\/osiris.itabc.cnr.it\/aton\/#website","url":"https:\/\/osiris.itabc.cnr.it\/aton\/","name":"ATON","description":"open-source Web3D\/WebXR framework by CNR ISPC","publisher":{"@id":"https:\/\/osiris.itabc.cnr.it\/aton\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/osiris.itabc.cnr.it\/aton\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/osiris.itabc.cnr.it\/aton\/#organization","name":"ATON","url":"https:\/\/osiris.itabc.cnr.it\/aton\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/osiris.itabc.cnr.it\/aton\/#\/schema\/logo\/image\/","url":"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2022\/12\/aton-logo-100.png","contentUrl":"https:\/\/osiris.itabc.cnr.it\/aton\/wp-content\/uploads\/2022\/12\/aton-logo-100.png","width":100,"height":100,"caption":"ATON"},"image":{"@id":"https:\/\/osiris.itabc.cnr.it\/aton\/#\/schema\/logo\/image\/"}}]}},"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/pages\/986","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/comments?post=986"}],"version-history":[{"count":27,"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/pages\/986\/revisions"}],"predecessor-version":[{"id":1090,"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/pages\/986\/revisions\/1090"}],"up":[{"embeddable":true,"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/pages\/695"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/media\/1046"}],"wp:attachment":[{"href":"https:\/\/osiris.itabc.cnr.it\/aton\/index.php\/wp-json\/wp\/v2\/media?parent=986"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}