Security News
npm Updates Search Experience with New Objective Sorting Options
npm has a revamped search experience with new, more transparent sorting options—Relevance, Downloads, Dependents, and Publish Date.
@astrojs/node
Advanced tools
This adapter allows Astro to deploy your SSR site to Node targets.
If you're using Astro as a static site builder—its behavior out of the box—you don't need an adapter.
If you wish to use server-side rendering (SSR), Astro requires an adapter that matches your deployment runtime.
Node.js is a JavaScript runtime for server-side code. @astrojs/node can be used either in standalone mode or as middleware for other http servers, such as Express.
Add the Node adapter to enable SSR in your Astro project with the following astro add
command. This will install the adapter and make the appropriate changes to your astro.config.mjs
file in one step.
# Using NPM
npx astro add node
# Using Yarn
yarn astro add node
# Using PNPM
pnpm astro add node
If you prefer to install the adapter manually instead, complete the following two steps:
Install the Node adapter to your project’s dependencies using your preferred package manager. If you’re using npm or aren’t sure, run this in the terminal:
npm install @astrojs/node
Add two new lines to your astro.config.mjs
project configuration file.
// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
export default defineConfig({
output: 'server',
adapter: node({
mode: 'standalone'
}),
});
@astrojs/node can be configured by passing options into the adapter function. The following options are available:
Controls whether the adapter builds to middleware
or standalone
mode.
middleware
mode allows the built output to be used as middleware for another Node.js server, like Express.js or Fastify.
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
export default defineConfig({
output: 'server',
adapter: node({
mode: 'middleware'
}),
});
standalone
mode builds to server that automatically starts with the entry module is run. This allows you to more easily deploy your build to a host without any additional code.First, performing a build. Depending on which mode
selected (see above) follow the appropriate steps below:
The server entrypoint is built to ./dist/server/entry.mjs
by default. This module exports a handler
function that can be used with any framework that supports the Node request
and response
objects.
For example, with Express:
import express from 'express';
import { handler as ssrHandler } from './dist/server/entry.mjs';
const app = express();
app.use(express.static('dist/client/'))
app.use(ssrHandler);
app.listen(8080);
Or, with Fastify (>4):
import Fastify from 'fastify';
import fastifyMiddie from '@fastify/middie';
import fastifyStatic from '@fastify/static';
import { fileURLToPath } from 'url';
import { handler as ssrHandler } from './dist/server/entry.mjs';
const app = Fastify({ logger: true });
await app
.register(fastifyStatic, {
root: fileURLToPath(new URL('./dist/client', import.meta.url)),
})
.register(fastifyMiddie);
app.use(ssrHandler);
app.listen({ port: 8080 });
Note that middleware mode does not do file serving. You'll need to configure your HTTP framework to do that for you. By default the client assets are written to ./dist/client/
.
In standalone mode a server starts when the server entrypoint is run. By default it is built to ./dist/server/entry.mjs
. You can run it with:
node ./dist/server/entry.mjs
For standalone mode the server handles file servering in addition to the page and API routes.
You can override the host and port the standalone server runs on by passing them as environment variables at runtime:
HOST=0.0.0.0 PORT=3000 node ./dist/server/entry.mjs
By default the standalone server uses HTTP. This works well if you have a proxy server in front of it that does HTTPS. If you need the standalone server to run HTTPS itself you need to provide your SSL key and certificate.
You can pass the path to your key and certification via the environment variables SERVER_CERT_PATH
and SERVER_KEY_PATH
. This is how you might pass them in bash:
SERVER_KEY_PATH=./private/key.pem SERVER_CERT_PATH=./private/cert.pem node ./dist/server/entry.mjs
You may see this when running the entry script if it was built with npm or Yarn. This is a known issue that will be fixed in a future release. As a workaround, add "path-to-regexp"
to the noExternal
array:
// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from "@astrojs/node";
export default defineConfig({
output: "server",
adapter: node(),
vite: {
ssr: {
noExternal: ["path-to-regexp"]
}
}
});
For more help, check out the #support
channel on Discord. Our friendly Support Squad members are here to help!
You can also check our Astro Integration Documentation for more on integrations.
This package is maintained by Astro's Core team. You're welcome to submit an issue or PR!
See CHANGELOG.md for a history of changes to this integration.
FAQs
Deploy your site to a Node.js server
The npm package @astrojs/node receives a total of 49,106 weekly downloads. As such, @astrojs/node popularity was classified as popular.
We found that @astrojs/node demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
npm has a revamped search experience with new, more transparent sorting options—Relevance, Downloads, Dependents, and Publish Date.
Security News
A supply chain attack has been detected in versions 1.95.6 and 1.95.7 of the popular @solana/web3.js library.
Research
Security News
A malicious npm package targets Solana developers, rerouting funds in 2% of transactions to a hardcoded address.