Configure MediaGoblin: Difference between revisions

From GNU MediaGoblin Wiki
Jump to navigation Jump to search
(Created page with "= The config files = So basically there are two config files (and one meta-config file). * '''mediagoblin.ini:''' Use this to configure MediaGoblin, the application. Want to u...")
 
No edit summary
Line 11: Line 11:
= Changing config files =
= Changing config files =


So you want to turn on (or off) all the bells and whistles, set up mediagoblin to use a storage system running out of a distributed cluster of Commodore 64s, change your email server configuration, etc. Where do you set all this stuff up?
So you want to

You should do the following:
<pre>
# copy the config files
$ cp paste.ini paste_local.ini
$ cp mediagoblin.ini mediagoblin_local.ini

# edit paste_local.ini to know where mediagoblin_local.ini is
$ editor mediagoblin_local.ini
</pre>

Find the line marked "config =" under [app:mediagoblin]; change to:

<pre>
[app:mediagoblin]
use = egg:mediagoblin#app
filter-with = beaker
config = %(here)s/mediagoblin_local.ini
</pre>

If you want to use lazyserver.sh, you can run it like:

<pre>
./lazyserver.sh -c paste_local.ini
</pre>

Also, all the ./bin/gmg commands have arguments to allow you to pass in the config file. For example:

<pre>
./bin/gmg shell -cf mediagoblin_local.ini
</pre>

(It's important to note that the ./bin/gmg commands don't care about the paster file, they just care about the mediagoblin config file.)

BTW, all these ./bin/gmg subcommands have help. You can check them like:

<pre>
./bin/gmg shell --help
</pre>

for more info.

Revision as of 23:35, 3 August 2011

The config files

So basically there are two config files (and one meta-config file).

  • mediagoblin.ini: Use this to configure MediaGoblin, the application. Want to use a different storage system? Configure it here!
  • paste.ini: This just actually configures the web server that launches the MediaGoblin application, and some other things (like actually sets up the applications that serve your static files).

And then there's the meta-config file:

  • mediagoblin/config_spec.ini: This sets the defaults for config file options and the type conversion for things in mediagoblin.ini. Developers who add new config options should probably register them and their types here (and set some good defaults, if applicable).

Changing config files

So you want to turn on (or off) all the bells and whistles, set up mediagoblin to use a storage system running out of a distributed cluster of Commodore 64s, change your email server configuration, etc. Where do you set all this stuff up?

You should do the following:

# copy the config files
$ cp paste.ini paste_local.ini
$ cp mediagoblin.ini mediagoblin_local.ini

# edit paste_local.ini to know where mediagoblin_local.ini is
$ editor mediagoblin_local.ini

Find the line marked "config =" under [app:mediagoblin]; change to:

[app:mediagoblin]
use = egg:mediagoblin#app
filter-with = beaker
config = %(here)s/mediagoblin_local.ini

If you want to use lazyserver.sh, you can run it like:

./lazyserver.sh -c paste_local.ini

Also, all the ./bin/gmg commands have arguments to allow you to pass in the config file. For example:

./bin/gmg shell -cf mediagoblin_local.ini

(It's important to note that the ./bin/gmg commands don't care about the paster file, they just care about the mediagoblin config file.)

BTW, all these ./bin/gmg subcommands have help. You can check them like:

./bin/gmg shell --help

for more info.