Skip to content

bun.md

Latest commit

 

History

History
83 lines (58 loc) · 1.92 KB

bun.md

File metadata and controls

83 lines (58 loc) · 1.92 KB
Raw

AIO Bun Image

The codjix/aio:bun image provides a lightweight container for running applications with the Bun JavaScript runtime. This image is built on top of the AIO base image and includes the Bun runtime environment.

Image Information

  • Base: codjix/aio:latest (Alpine 3.20)
  • Architecture: amd64, arm64
  • Current Version: 1.2.9

Features

  • Bun JavaScript runtime
  • Preinstalled bunx command for package execution
  • Optimized for minimal footprint
  • User with ID 1000 for running Bun applications

Usage

Basic Usage

# Start a Bun REPL
docker run -it --name aio-bun codjix/aio:bun

# Run a Bun script
docker run -it --name aio-bun -v $(pwd):/app -w /app codjix/aio:bun bun run index.ts

Running a Web Application

docker run -d --name aio-bun-app -v $(pwd):/app -w /app -p 3000:3000 codjix/aio:bun bun run index.ts

Environment Variables

  • BUN_RUNTIME_TRANSPILER_CACHE_PATH: Set to 0 by default to disable the runtime transpiler cache
  • BUN_INSTALL_BIN: Path for global bun installs, defaults to /usr/local/bin

Volumes

Mount your application code to any directory, commonly /app:

docker run -it -v $(pwd):/app -w /app codjix/aio:bun

Working with Dependencies

To install and use dependencies with Bun:

# Install dependencies
docker run -it -v $(pwd):/app -w /app codjix/aio:bun bun install

# Run with dependencies
docker run -it -v $(pwd):/app -w /app codjix/aio:bun bun run start

Docker Compose Example

version: '3'

services:
  bun-app:
    image: codjix/aio:bun
    container_name: aio-bun-app
    ports:
      - "3000:3000"
    volumes:
      - ./app:/app
    working_dir: /app
    command: bun run index.ts
    environment:
      - NODE_ENV=development
      - BUN_RUNTIME_TRANSPILER_CACHE_PATH=0

Source Code

The Dockerfile and associated scripts for this image are available in the src/bun directory of the AIO repository.