Astro.js

[jeffscottward]

It's unclear how to deploy any version of Astro.js, static or SSR, on Coolify right now. And it's become the hot new favorite for people who don't love the heavy handed approach of Next.js.

How do we deploy it?

[maietta]

The best way, IMO is to containerize your app via Docker and using a Dockerfile.

There should be some examples laying around that can guide you on this. Deploy using a Dockerfile.

[maietta]

Further, here is my multi-state Dockerfile for containerizing my SvelteKit apps using Bun with Node available and cURL for healthchecks if you set /healthcheck to respond with "OK" in your app.

The reason I included Node even though I'm using Bun, is because some applications work better with, or may require the use of Node, such as if you're using the Prisma client. Included is an example of the Prisma related tasks. The --bun at the end of this file is to tell Bun only to use the Bun runtime. Useful if you need Bun specific APIs.

ARG BUN_VERSION=1.1.42
FROM oven/bun:${BUN_VERSION} AS builder

# Install required dependencies
RUN apt-get update && \
    apt-get install -y \
    curl \
    xz-utils \
    && rm -rf /var/lib/apt/lists/*

# Set the Node.js version
ENV NODE_VERSION=22.11.0

# Download and install Node.js
RUN curl -fsSL https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64.tar.xz -o node-v${NODE_VERSION}-linux-x64.tar.xz && \
    tar -xf node-v${NODE_VERSION}-linux-x64.tar.xz && \
    mv node-v${NODE_VERSION}-linux-x64 /usr/local/node && \
    ln -s /usr/local/node/bin/node /usr/local/bin/node && \
    ln -s /usr/local/node/bin/npm /usr/local/bin/npm && \
    ln -s /usr/local/node/bin/npx /usr/local/bin/npx && \
    rm node-v${NODE_VERSION}-linux-x64.tar.xz

# Verify installation
RUN node --version && npm --version

WORKDIR /app

# Set environment variables
ENV NODE_ENV=production

COPY --link bun.lockb package.json ./
RUN bun install --ci

# Generate Prisma Client
# COPY --link prisma .
# RUN bun x prisma generate

# Copy application code
COPY --link . .

# Build application (explicit use of Bun runtime only to support bun:sqlite, using the --bun flag)
RUN bun --bun run vite build

# Remove development dependencies
#RUN rm -rf node_modules && bun install --ci

FROM oven/bun:${BUN_VERSION}

# Copy Node.js binaries and curl from the builder stage
COPY --from=builder /usr/local/node /usr/local/node
COPY --from=builder /usr/bin/curl /usr/bin/curl
COPY --from=builder /usr/lib/x86_64-linux-gnu /usr/lib/x86_64-linux-gnu

# Create symbolic links to Node.js binaries
RUN ln -s /usr/local/node/bin/node /usr/local/bin/node && \
    ln -s /usr/local/node/bin/npm /usr/local/bin/npm && \
    ln -s /usr/local/node/bin/npx /usr/local/bin/npx

# Copy the built application and necessary files from the builder stage
COPY  --chown=bun:bun  --from=builder /app /app

#
ENV PORT=3000
EXPOSE 3000/tcp

# Set user and define healthcheck
USER bun
# HEALTHCHECK --interval=5s --timeout=5s --start-period=5s --retries=3 CMD curl --fail http://localhost:3000/healthcheck

CMD ["bun", "--bun", "/app/build/index.js"]