Docker is a tool to build, deploy, and run applications using containers.
Docker images and containers can be deployed to many different platforms, like AWS, Azure, and Google Cloud. This recipe won’t cover how to deploy your site to a specific platform but will show you how to set up Docker for your project.
PrerequisitesSection titled Prerequisites
- Docker installed on your local machine. You can find installation instructions for your operating system here.
- A Dockerfile in your project. You can learn more about Dockerfiles here and use the Dockerfiles in the following section as a starting point.
Creating a DockerfileSection titled Creating a Dockerfile
Create a file called
Dockerfile in your project’s root directory. This file contains the instructions to build your site, which will differ depending on your needs. This guide can’t show all possible options but will give you starting points for SSR and static mode.
If you’re using another package manager than npm, you’ll need to adjust the commands accordingly.
This Dockerfile will build your site and serve it using Node.js on port
4321 and therefore requires the Node adapter installed in your Astro project.
Adding a .dockerignoreSection titled Adding a .dockerignore
.dockerignore file to your project is best practice. This file describes which files or folders should be ignored in the Docker
ADD commands, very similar to how
.gitignore works. This speeds up the build process and reduces the size of the final image.
This file should go in the same directory as the
Dockerfile itself. Read the
.dockerignore documentation for extra info
StaticSection titled Static
Apache (httpd)Section titled Apache (httpd)
The following Dockerfile will build your site and serve it using Apache htppd on port
80 with the default configuration.
NGINXSection titled NGINX
In order to build the Dockerfile above, you’ll also need to create a configuration file for NGINX. Create a folder called
nginx in your project’s root directory and create a file called
Multi-stage build (using SSR)Section titled Multi-stage build (using SSR)
Here’s an example of a more advanced Dockerfile that, thanks to Docker’s multi-stage builds, optimizes the build process for your site by not reinstalling the npm dependencies when only the source code changes. This can reduce the build time even by minutes, depending on the size of your dependencies.
RecipeSection titled Recipe
- Build your container by running the following command in your project’s root directory. Use any name for
This will output an image, which you can run locally or deploy to a platform of your choice.
- To run your image as a local container, use the following command.
<local-port> with an open port on your machine. Replace
<container-port> with the port exposed by your Docker container (
8080 in the above examples.)
You should be able to access your site at
- Now that your website is successfully built and packaged in a container, you can deploy it to a cloud provider. See the Google Cloud deployment guide for one example, and the Deploy your app page in the Docker docs.
Learn how to share state across framework components with Nano Stores.
Add an RSS feed to your Astro site to let users subscribe to your content.
Learn how you can import YAML data by adding a Rollup plugin to your project.
Learn how to build HTML forms and handle submissions in your frontmatter
Learn how to use Bun with your Astro site.
Learn how to call endpoints from the server in Astro.
Learn how to create an API route and fetch it from the client.
Learn how to build your Astro site using Docker.
Learn how to install a rehype plugin to add icons to external links in your Markdown files
Use dynamic routing and content collections to add internationalization support to your Astro site.
Build a remark plugin to add the last modified time to your Markdown and MDX.
Build a remark plugin to add reading time to your Markdown or MDX files.
Learn how to share state across Astro components with Nano Stores.