XWiki is a powerful open source wiki and collaboration platform that goes far beyond a standard wiki. It supports structured data, applications built with wiki pages, scripting, a rich extension ecosystem, and fine-grained access controls. You can use it as a company knowledge base, project documentation system, or internal app-building platform. Available as an open web service in Eyevinn Open Source Cloud.

• If you have not already done so, sign up for an Eyevinn OSC account

XWiki stores all pages, users, and configuration in a relational database. Navigate to the PostgreSQL service in the OSC web console and create a new instance. Enter a name and a password when prompted.

Once the instance is running, note the IP and port shown on the instance card. XWiki requires a JDBC-format connection URL. Construct it from the details on the instance card:

jdbc:postgresql://postgres:<password>@<IP>:<PORT>/postgres

Note that the scheme must be jdbc:postgresql://, not postgres://. Passing a postgres:// URL causes XWiki to fail on startup with a "JDBC URL" driver error.

Navigate to the XWiki service and open the Service Secrets tab. Click New Secret and create:

• dburl — the JDBC connection URL from Step 1 (must start with jdbc:postgresql://)

Go to the My xwiki-platforms tab and click Create xwiki-platform. Fill in:

• Name: a unique name for your instance (alphanumeric only, e.g. mywiki)
• DatabaseUrl: {{secrets.dburl}}

Click Create and wait for the status indicator to turn green. The first startup takes a minute or two as XWiki initialises the database schema.

Click the instance URL to open the XWiki web interface. Log in with the default administrator credentials:

Change the admin password immediately after first login. Navigate to Admin → Users → Admin → Edit to set a new password.

After logging in you will be prompted to complete a short setup wizard to configure the wiki name, register an admin email, and install the Standard XWiki flavour (recommended). Once setup completes your wiki is ready to use.

XWiki exposes a REST API for reading and writing pages. To fetch the home page content:

curl -u Admin:admin \
  "https://<your-instance-url>/rest/wikis/xwiki/spaces/Main/pages/WebHome"

To create or update a page:

curl -u Admin:admin -X PUT \
  -H "Content-Type: application/xml" \
  -d '<page xmlns="http://www.xwiki.org"><title>My Page</title><content>Hello **world**!</content></page>' \
  "https://<your-instance-url>/rest/wikis/xwiki/spaces/Demo/pages/MyPage"

osc create xwiki-xwiki-platform mywiki \
  -o DatabaseUrl="jdbc:postgresql://postgres:[email protected]:10505/postgres"

• XWiki documentation
• XWiki REST API guide
• XWiki on GitHub