diff --git a/docs/src/charm/howto/install/charm.md b/docs/src/charm/howto/install/charm.md
index 0c1892e8a..8bea4610a 100644
--- a/docs/src/charm/howto/install/charm.md
+++ b/docs/src/charm/howto/install/charm.md
@@ -89,8 +89,8 @@ Use `juju status` to watch these units approach the active/idle state.
 <!-- LINKS -->
 
 [Installing]:    ./index
-[channels]:      ../explanation/channels
+[channels]:      ../../explanation/channels
 [credentials]:   https://juju.is/docs/juju/credentials
 [juju]:          https://juju.is/docs/juju/install-juju
 [charm]:         https://juju.is/docs/juju/charmed-operator
-[localhost]:     ../howto/install-lxd
+[localhost]:     install-lxd
diff --git a/docs/src/charm/howto/custom-workers.md b/docs/src/charm/howto/install/custom-workers.md
similarity index 100%
rename from docs/src/charm/howto/custom-workers.md
rename to docs/src/charm/howto/install/custom-workers.md
diff --git a/docs/src/charm/howto/install/index.md b/docs/src/charm/howto/install/index.md
index 36cfa4803..67457520b 100644
--- a/docs/src/charm/howto/install/index.md
+++ b/docs/src/charm/howto/install/index.md
@@ -16,4 +16,5 @@ Install from a charm <charm.md>
 Install in LXD <install-lxd.md>
 Install with Terraform <install-terraform.md>
 Install with a custom configuration <install-custom.md>
+Install with custom worker configuration <custom-workers.md>
 ```