# Custom domains

You can set up a custom domain or subdomain for your Obsidian Publish site.

The easiest way to set up a custom domain or subdomain is to create a CloudFlare account and let CloudFlare manage your domain's DNS.

The following steps use CloudFlare to configure a custom domain for your Obsidian Publish site, either using a root domain (mysite.com) or a subdomain (notes.mysite.com).

CloudFlare:

1. Open Cloudflare to the domain where you want to host your Publish site, such as mysite.com, even if you want a subdomain like notes.mysite.com.
2. Go to DNS and click Add Record.
3. Select CNAME.
4. In name, enter your domain or subdomain, for example notes.mysite.com.
5. In target, enter publish-main.obsidian.md. Don't include your personal sub-URL in this value. Obsidian Publish handles this from your configuration.
6. Make sure that proxy status is enabled. It should be enabled by default.
7. Go to SSL/TLS and set the SSL/TLS encryption mode to "Full" to configure the SSL/TLS certificate automatically.

Obsidian:

1. Open Obsidian on your computer.
2. In the Ribbon at the left, click Publish changes ( ).
3. Under Publish changes, select Change site options ( ).
4. Next to Custom domain, select Configure.
5. In Custom URL, enter the URL to your domain or subdomain. Make sure to not put www. in the custom URL box.

You can also set up SSL/TLS for your custom domain by using your own web server.

If you are already hosting a website under your domain or subdomain, you can also use this option and set up your website to load your Obsidian Publish site under a specific URL path, instead of hosting the full site.

Proxy all requests under that URL path to https://publish.obsidian.md/serve?url=mysite.com/my-notes/... and configure the site options in Obsidian to the same URL path, by setting Custom URL to mysite.com/my-notes.

You can also set up Obsidian Publish as a sub-URL of a site you own. For example, https://mysite.com/my-notes/. To achieve this, you must host your own server and proxy all requests to our server at https://publish.obsidian.md/.

The following proxy setup examples are not exhaustive, but provide common methods for this implementation.

In your NGINX configuration, add the following:

location /my-notes {
  proxy_pass https://publish.obsidian.md/serve?url=mysite.com/my-notes/;
  proxy_ssl_server_name on;
  proxy_set_header Host publish.obsidian.md;
}

Some users have reported that adding $request_uri to the proxy pass may be required:

location /my-notes {
  proxy_pass https://publish.obsidian.md/serve?url=mysite.com/my-notes$request_uri;
  proxy_ssl_server_name on;
  proxy_set_header Host publish.obsidian.md;
}

In .htaccess, add the following:

RewriteEngine  on
RewriteRule    "^my-notes/(.*)$"  "https://publish.obsidian.md/serve?url=mysite.com/my-notes/$1"  [L,P]

In netlify.toml, configure redirects:

[[redirects]]
  from = "https://mysite.com/my-notes/*"
  to = "https://publish.obsidian.md/serve?url=mysite.com/my-notes/:splat"
  status = 200
  force = true

In vercel.json, configure rewrites:

{
  ...

  "rewrites": [
    {
      "source": "/my-notes/",
      "destination": "https://publish.obsidian.md/serve?url=mysite.com/my-notes"
    },
    {
      "source": "/my-notes/:path*",
      "destination": "https://publish.obsidian.md/serve?url=mysite.com/my-notes/:path*"
    }
  ]
}

mysite.com {
  encode zstd gzip
  handle /my-notes* {
    reverse_proxy https://publish.obsidian.md {
      header_up Host {upstream_hostport}
    }
    rewrite * /serve?url=mysite.com{path}
  }
}

This minimal configuration excerpt redirects mysite.com to Obsidian publish. See the Traefik documentation for a complete example.

http:
  routers:
    mysite:
      rule: Host(`mysite.com`)
      service: obsidian-publish
      middlewares:
        - "publish-headers"
  services:
    obsidian-publish:
      loadBalancer:
        servers:
          - url: https://publish.obsidian.md
  middlewares:
    publish-headers:
      headers:
        customRequestHeaders:
          Host: "publish.obsidian.md"
          x-obsidian-custom-domain: "mysite.com"

If your proxy service doesn't allow query paths, you can use https://publish.obsidian.md/ with a custom header x-obsidian-custom-domain set to your site URL mysite.com/my-subpath.

If you want to redirect your visitors from the old publish.obsidian.md site to your new custom domain, enable the Redirect to your custom domain option when configuring your custom domain.

Once you set up your custom domain, if you've visited your site from your previous https://publish.obsidian.md/slug link, you may have to clear your browser cache for certain things (like fonts, graphs, or password access) to work properly. This is due to the cross-domain security restrictions that are imposed by modern browsers. The good news is that readers of your site should never run into issue this if you only let visitors use your custom domain.