agus sarwono - programming for dummies

Simplified Guide Setting Up a Local Domain with Caddy Server


In the realm of web development and local testing environments, creating custom local domain can streamline the devepment process. this guide walks you the steps to set up a new local domain using Caddy Server


  • CaddyServer: make sure you have caddy installed on your system, if you haven’t installed it yet, You can download and install it from the official Caddy website

  • Text Editor (vscode,vim, etc…), have a text editor of your choice. In this guide, we’ll use Vim, but you can subtitute it with Nano, Emacs, or any other text editor your prefer

Now that you have the necessary tools in place, lets proceed with the setting up your new local domain

Step 1: Edit the Hosts file

The Journey begin in the terminal, where you’ll navigate to the /etc/hosts file and a new entry for your desired local domain. This foundational step establishes the connection between the chosen domain and your localhost, paving the way for seamless local development.

sudo vim /etc/hosts example.local

Step 2: Update Caddyfile Configuration

Caddy, the modern and user-friendly web server, requires specific configurations to recognize and handle your newly created local domain. Leverage the Caddyfile syntax to tailor the server’s behavior for your development needs. This step involves defining rules, proxy passes, or any other configurations pertinent to your project.

(proxy) {

reverse_proxy localhost:{args.0}

example.local {
	proxy 4444

Step 3: Restart or Reload Caddy

After making changes to the Caddyfile, it’s crucial to restart or reload the Caddy server to apply the new configurations. Use the following commands based on your system:

sudo systemctl reload caddy