dokuwiki-addsite(1)

💖 dokuwiki-addsite — bestie edition 💖

okay so this is a page from the General Commands Manual section, and it's all about dokuwiki-addsite(1). it spins up a brand new site on top of your existing DokuWiki engine. no cap, it's giving "wiki farm manager" energy. 🌾✨

---

🌸 NAME 🌸

dokuwiki-addsite — bestie, this creates a whole new site that's driven by DokuWiki 🫶

---

✨ SYNOPSIS ✨

dokuwiki-addsite ['OPTIONS'] {'SITE_NAME'}

---

💅 DESCRIPTION 💅

so, DokuWiki? it's a standards compliant, simple to use wiki, and its whole main character moment is creating documentation of literally any kind. 📚

and dokuwiki-addsite? it creates the file hierarchy and the configuration you need to define a new site driven by the installed DokuWiki engine. boom. new site. slay. 👑

---

🎀 OPTIONS 🎀

• --no-admin — this makes it so it doesn't create any administrator user, and it will not ask you for a password. no password prompt, no admin account, just vibes. 🙈
• -h, --help — shows you a help message and then exits. classic. helpful icon behavior. 💖
• SITE_NAME — the name of the site you're creating, and okay this one has layers, so let's break it down:
  • for a virtual host-based setup, it reflects the corresponding hostname. like, say your site is reachable at an address such as <http://wiki.project.example.com:8080/foo/bar/> — then SITE_NAME can be either project.example.com, wiki.project.example.com, wiki.project.example.com.foo.bar, or even 8080.wiki.project.example.com.foo.bar. yes really, all of those are valid, pick your fave. 🌈
  • for a directory or htaccess-based setup, this is the corresponding site identifier. for instance, if your site is reachable at an address such as <http://wiki.example.com/project/>, rewritten by the web server as doku.php?animal=project, then it is simply project. that's it, that's the whole name. 🍓

---

🔥 NOTES 🔥

the site configuration gets stored in /etc/dokuwiki/farm/SITE_NAME/, and the data gets stored in /var/lib/dokuwiki/farm/SITE_NAME/, exactly as it says in the site configuration. know your paths, bestie. 📁

in a virtual host-based setup, if you need to make a given site accessible at several URLs, you can symlink its configuration directory to another name. and listen — it is not necessary to symlink the data directory. save yourself the effort. 🦋

if you need to rename a site, you can rename the configuration and data directories, and then edit the configuration so it points to the new data directory. easy. periodt. 💜

---

💀 BUGS 💀

ngl, there is no check done against the SITE_NAME, so just avoid names like ../../../etc. okay?? please. 🙏

and if you find any bug, report it to the Debian BTS. ty bestie, you're doing amazing sweetie. 🫶

---

👑 SEE ALSO 👑

• dokuwiki-delsite(1)
• <http://www.dokuwiki.org/tips:farm>

---

🌟 AUTHORS 🌟

Tanguy Ortolo <<tanguy+debian@ortolo.eu>>

---

and that's the whole page, bestie!! this one came from the DokuWiki manual, version dokuwiki, and it's the dokuwiki-addsite(1) page. mwah. go forth and farm those wikis. 💖✨🎀