This article is intended for wiki administrators.
The main way to configure your Mycorrhiza instance is through the configuration file. It is located at the root of your wiki structure and is called
The file is generated automatically when you create a new wiki:
# Generate a new wiki $ mycorrhiza best-wiki ... # See what's inside $ ls best-wiki cache config.ini static wiki.git
The file is written in the .ini format.
The auto-generated file is the best example (it has comments too).
Here's an example of a configuration file adapted from the default:
WikiName = My wiki NaviTitleIcon = 🐑 [Hyphae] HomeHypha = home UserHypha = u HeaderLinksHypha = header-links [Network] ListenAddr = 0.0.0.0:8080 URL = https://wiki [Authorization] UseAuth = true AllowRegistration = true
WikiName: string. The name your wiki has. It is shown in the header by default and in other places. Default:
NaviTitleIcon: string. The icon shown before the colon in the navigational titles above each hypha. You may want to use an emoji or HTML here. Default:
UseSiblingHyphaeSidebar: boolean. Whether to show the sibling hyphae sidebar. You are discouraged from using the sibling hyphae sidebar on new wikis. Enable it on old wikis that depend on it heavily. Default:
HomeHypha: string. The name your home hypha has. Default:
UserHypha: string. The name of the hypha that is parent of all user hyphae. Default:
HeaderLinkHypha: string. The name of the hypha where you can configure the header. See /help/en/top_bar. There is no default.
ListenAddr: number. What port is used for serving the web interface of Mycorrhiza. Default:
URL: url. What URL is used for Opengraph and Web feed in the web interface. There is no default and you really should set it to something.
UseAuth: boolean. Whether to enable authorization system. Default:
AllowRegistration: boolean. Whether you want unregistered visitors to be able to register themselves using the web form. Default:
RegistrationLimit: number. There cannot be more registered users than this number. If the number is zero, there is no limit. Makes sense only when
Locked: boolean. Whether the users have to authorize first to access the wiki. Default:
UseWhiteList: boolean. Whether to use a whitelist to allow specific users in. Default:
WhiteList: list of strings. Usernames of people to allow in, if
UseWhiteListis turned on. Default:
CommonScripts: list of url. Comma-separated list of unquoted URLs to JS files to load on all pages.
ViewScripts: list of urls. Comma-separated list of unquoted URLs to JS files to load on view pages:
EditScripts: list of urls. Comma-separated list of unquoted URLs to JS files to load on the
You can set up Telegram-based authorization. You have to define both parameters.
TelegramBotToken: string Token of your bot. There is no default.
TelegramBotName: string Username of your bot, sans @. There is no default.