Yukki::Settings - provides structure and validation to settings in yukki.conf


version 0.140290


This class provides structure for the main application configuration in Yukki.

Yukki may fail to start unless your configuration is correct.



This is the wiki site directory. This should be the same folder that was given the yukki-setup command. It works best if you make this an absolute path.


This is the folder where Yukki will find the git repositories installed under root. The default is root/repositories.


This is the folder where the list of user files can be found.


This is the name of the digest algorithm to use to store passwords. See Digest for more information. The default is "SHA-512".

N.B. If you change digest algorithms, old passwords saved with the old digest algorithm will continue to work as long as the old digest algorithm class is still installed.


This is a section configuring anonymous user information.


This is the name to use when an anonymous user makes a change to a wiki repository.


This is the email address to use when an anonymous user makes a change to a wiki repository.


This is a section under which each repository is configured. The keys under here are the name found in the URL. It is also the name to use when running the yukki-git-init and other repository-related commands.

Each repository configuraiton should provide the following configruation keys.


This is required. This is the name of the git repository folder found under repository_path.


This is teh name of the branch that will contain the wiki's files. The default is refs/heads/master. You could actually use the same git repository for multiple Yukki repositories by using different branches. If you want to do it that way for some reason. Unless you know what you're doing, you probably don't want to do that.


This is a human readable title for the repository.


This is the name of the main repository index.


This should be set to one of the following: read, write, or none. This settings decides how much access an anonymous user has when visiting your wiki.


This may be set to the word "ANY" or the word "NONE" or to an array of group names.

If set to ANY, any logged user may read this repository. If set to NONE, read access is not granted to any logged user (though if anonymous_access_level or write_groups grant a user access, the user will be able to read the repository).

If an array of one or more group names are given, the users with any of those groups will be able to read the repository.


THe possible values that may be set are identicl to read_groups. This setting determines who has permission to edit pages and upload files to the repository.


Andrew Sterling Hanenkamp <>


This software is copyright (c) 2014 by Qubling Software LLC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.