MacOS setup

In the future, we might provide a script to automate this process, but for now, it's a manual process.

Install Brew

# install homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install Deno

brew install deno

Setup Smallweb

brew install pomdtr/tap/smallweb
smallweb service install

Setup Caddy

Caddy’s configuration path depends on whether you're using an Intel-based Mac or an Apple Silicon (M1/M2) Mac.

• For Apple Silicon Macs:

  brew install caddy
  
  # Write caddy configuration
  cat <<EOF > /opt/homebrew/etc/Caddyfile
  smallweb.localhost, *.smallweb.localhost {
    tls internal
  
    reverse_proxy localhost:7777
  }
  EOF

• For Intel-based Macs:

  brew install caddy
  
  # Write caddy configuration
  cat <<EOF > /usr/local/etc/Caddyfile
  smallweb.localhost, *.smallweb.localhost {
    tls internal
  
    reverse_proxy localhost:7777
  }
  EOF

Run Caddy

# Run caddy in the background
brew services start caddy

# Add caddy https certificates to your keychain
caddy trust

Setup dnsmasq

The configuration path for dnsmasq also depends on your Mac's architecture.

• For Apple Silicon Macs:

  brew install dnsmasq
  
  # Write dnsmasq configuration
  echo "address=/.localhost/127.0.0.1" >> /opt/homebrew/etc/dnsmasq.conf

• For Intel-based Macs:

  brew install dnsmasq
  
  # Write dnsmasq configuration
  echo "address=/.localhost/127.0.0.1" >> /usr/local/etc/dnsmasq.conf

Run dnsmasq

# Run dnsmasq in the background
sudo brew services start dnsmasq

# Indicates to the system to use dnsmasq for .localhost domains
sudo mkdir -p /etc/resolver
cat <<EOF | sudo tee -a /etc/resolver/localhost
nameserver 127.0.0.1
EOF

Testing the setup

First, let's create a dummy smallweb website:

mkdir -p ~/smallweb/example
cat <<EOF > ~/smallweb/example/main.ts
export default {
  fetch() {
    return new Response("Smallweb is running");
  }
}
EOF

If everything went well, you should be able to access https://example.smallweb.localhost in your browser, and see the message Smallweb is running.