Update docs
This commit is contained in:
@@ -0,0 +1,32 @@
|
||||
# Redirecting your root domain to a share
|
||||
|
||||
If you have a dedicated domain for your photos, you might want the root of that domain
|
||||
to open a specific share, rather than showing the default IPP landing page. For example:
|
||||
|
||||
```
|
||||
photos.yourdomain.net → your photo album
|
||||
```
|
||||
|
||||
IPP deliberately doesn't do this itself - storing a share path would mean storing a key,
|
||||
which goes against the design goal of being stateless and knowing nothing about your
|
||||
Immich instance. Instead, handle it at the reverse proxy level.
|
||||
|
||||
## Examples
|
||||
|
||||
### Caddy
|
||||
|
||||
```
|
||||
photos.yourdomain.net {
|
||||
# Redirect the root to your share
|
||||
redir / /s/example-share 302
|
||||
# Alternatively you could rewrite, so the gallery appears at the root:
|
||||
#rewrite / /s/example-share
|
||||
reverse_proxy immich-public-proxy:3000
|
||||
}
|
||||
```
|
||||
|
||||
Use `redir` to send visitors to the share URL, or `rewrite` if you want the gallery
|
||||
to appear at the root of your domain without changing the URL in the browser.
|
||||
|
||||
The example above uses a named slug link (`/s/example-share`). This works the same
|
||||
with a standard share link, e.g. `/share/ffSw63qnIYMtpmg0RNvO...`.
|
||||
@@ -1,8 +1,8 @@
|
||||
# Running IPP on a single domain with Immich
|
||||
|
||||
Because everything related to IPP happens within the `/share` path,
|
||||
Because everything related to IPP happens within the `/share` and `/s` paths,
|
||||
you can serve Immich and IPP on the same domain by configuring your reverse
|
||||
proxy to send all `/share/*` requests to IPP.
|
||||
proxy to send all `/share/*` and `/s/*` requests to IPP.
|
||||
|
||||
## Caddy
|
||||
|
||||
@@ -11,7 +11,7 @@ proxy to send all `/share/*` requests to IPP.
|
||||
```
|
||||
https://your-domain.com {
|
||||
# Immich Public Proxy paths
|
||||
@public path /share /share/*
|
||||
@public path /share /share/* /s/*
|
||||
handle @public {
|
||||
# Your IPP server and port
|
||||
reverse_proxy YOUR_SERVER:3000
|
||||
|
||||
Reference in New Issue
Block a user