The internal name of the admin UI is:
Grok Application Interface Application or, for short GAIA.
GAIA is itself a Grok application and a subproject to the core Grok
development. Its main goal is making developing of Zope 3 and Grok
applications a faster and smarter job with more fun for everybody.
Login - what is my username/password?
Before you can use the admin UI, you first must log in.
The username and password of the manager principal (kind of super
user) can be found in the file buildout.cfg in the root of your
In case you do not know, what ‘subversion checkout’ means, look for a
file site.zcml in your installation.
Users of grokproject, might find this file in
Using the admin-UI
After login you can visit some of the main management topics, as
On top of the admin-UI you can always find three links to the main
management activities currently possible with GAIA:
- List of all instanciated applications
- You can add new instances of Grok applications
- You can rename instances of Grok applications
- You can delete your installed applications.
starting with version 0.5 there is no introspector/class
browser included in grokui.admin anymore. Eventually this will be
made availabel in another package by someone else.
Set security notifications. Those are by default disabled, because
they mean home-calling functionality you may do not want. You can
enable/disable those notifications or set a URL to retrieve
information about security related problems.
Start/Restart the server. Caution! This does not work, if the server
was started in ‘foreground mode’ (with ‘zopectl fg’).
Pack the ZODB. This removes old data from the database, freeing up
disk space. In a production environment, you might want to pack the
ZODB automatically from cron. This can be done using a command
like the following:
curl -q -s -u admin:admin "http://localhost:8080/++grokui++/@@server?pack=1&days=1"
which will remove old data older than one day. If you leave out the
days parameter, all old data will be removed.
Get basic information about the running Zope system.
Enter a message to be displayed on top. You can, for example, leave
a message here for your co-admins. To delete the message, just enter
the empty string in the appropriate input box.
Maintaining grok installations with the admin UI
There are some special info views available especially for the use of
system administrators that want to automate Grok administration in
some aspects. They provide minimal information about certain topics.
Currently the following infos are available this way:
The grok version working in background:
curl -q -s -u admin:admin "http://localhost:8080/++grokui++/@@admin/@@version"
The security notification (if any):
curl -q -s -u admin:admin "http://localhost:8080/++grokui++/@@admin/@@secnote"
Beside this you can pack the ZODB databases as described above.
Bugs, Caveats and Ways to Get Help
The Grok admin UI has been refactored during the Cologne Neanderthal Sprint
II, in september 2009.
As a matter of fact, it is still under development and
improvement. Please, report any misbehavior or bug.
For bugreports use:
For discussions subscribe to the grok-dev mailing list, hosted on:
The projects’ home is the subversion repository at:
Grok’s cave can be found at