andreysmelter/ubuntu-foswiki repository overview

⁠ubuntu-foswiki

This Dockerfile contains instructions on how to build an image with Foswiki 2.1.6 based on Ubuntu 18.04 (LTS).

⁠Links:

• @GitHub⁠
• @DockerHub⁠

⁠Install

1. Install docker:
   • Follow instructions to install docker for your system: https://docs.docker.com/engine/installation⁠
     • Ubuntu⁠
     • Debian⁠
     • CentOS⁠
     • Fedora⁠
     • Mac⁠
     • Windows⁠
2. Install ubuntu-foswiki:
   • pull built image from the docker hub:

   # docker pull andreysmelter/ubuntu-foswiki
   # docker tag andreysmelter/ubuntu-foswiki:latest ubuntu-foswiki:latest  # retag docker image
   # docker rmi andreysmelter/ubuntu-foswiki                # remove after you have retagged it
   

   Copy
   • or build an image using Dockerfile at the root of this repo by running docker build from directory containing Dockerfile:

   # docker build -t ubuntu-foswiki .
   

   Copy

⁠Run Foswiki

1. To run Foswiki:

# docker run -t -p 4000:80 ubuntu-foswiki

1. Go to the following address: http://localhost:4000/foswiki

The image contains unconfigured Foswiki installation where you will need to save paths, set admin password, register user, etc.

⁠Configure Foswiki

⁠Foswiki Tutorial

Visit Foswiki Documentation to learn more:

• Documentation⁠

Slide show presentation for beginners:

• Presentation⁠

⁠General Configuration

1. Visit configure page (follow the link from the main page).

2. Add Internal Admin Password under Security and Authentication -> Passwords.

3. Add your UserName to Access to Configure (users who can access configure page) under Security and Authentication -> Access Control.

4. Save configure page.

5. Go to http://localhost:4000/foswiki/System/UserRegistration and register your UserName.

6. Go to http://localhost:4000/foswiki/Main/AdminGroup and add your UserName to AdminGroup.

⁠Additional Configuration

• To protect main page with login screen:

  1. Go to http://localhost:4000/foswiki/Main/WebPreferences.
  2. Under Access control find Set ALLOWWEBVIEW = and change it to Set ALLOWWEBVIEW = AdminGroup.
  3. Under Access control find Set ALLOWWEBCHANGE = and change it to Set ALLOWWEBCHANGE = RegistrationAgent.

• To create new webs:

  1. Go to http://localhost:4000/foswiki/System/ManagingWebs.
  2. Create new Web.