Help doc site
So you've downloaded Docs Site β here's everything you need to get it
running and where to go if something isn't working.
#Getting it running
- Upload all the files to your web host (the root of your domain works
best β see the note below if you're using a subfolder). - Create the database by importing
schema.sqlwith your MySQL/MariaDB
tool of choice. - Open
config.phpand fill in your database username, password, and
host. - Visit your site and log in at
/login.phpwith the default admin
account β then change that password immediately from
Site Settings.
That's it β you're ready to create categories and start writing articles.
#Common setup issues
Pretty links (like /getting-started) give a 404.
Your host needs mod_rewrite enabled and .htaccess files allowed. Most
shared hosts have this on by default; if not, ask your host to enable it
for your domain.
Some emoji or special characters look garbled after import.
Re-import schema.sql using --default-character-set=utf8mb4 on the
import command β a plain import can corrupt non-English characters
depending on your MySQL client's default settings.
Some parts of the page look unstyled β plain text instead of proper
boxes and cards.
This almost always means your browser (or a CDN in front of your host)
is holding onto an old cached copy of the stylesheet. Try a hard refresh
(Ctrl+Shift+R / Cmd+Shift+R) or open the site in a private window. If
you're upgrading an existing install, make sure you fully replace the old
files rather than uploading the new ones on top.
#Customizing your site
Everything below is controlled from the admin dashboard β no code
required:
- Site Settings β title, tagline, footer text, and your Discord invite
link - Feature Toggles β turn search, the Discord button, or the feedback
widget on or off - Categories & Articles β organize your docs, save drafts before
publishing, and hide a category without deleting it
#Still stuck?
Ask in Discord
Was this article helpful?