Running online club meetings with OpenSlides


During the COVID pandemic, many organisations had little choice but to hold their meetings online. Back in 2020, temporary German rules allowed this under certain conditions even if a club's articles didn't explicitly provide for it (the source I used at the time).

That raised a very practical question for me: How do we actually run such a meeting?

After some research I picked OpenSlides, a tool for organising and managing meetings, including in-person ones.

To make the meeting fully online, you also need video conferencing. There were several options: Jitsi, BigBlueButton, Google Meet, Zoom and Skype. My interest was mostly in the first two because they're open source.

Historical article from November 2020: The legal references, versions, service lists and commands reflect that period. German association law and OpenSlides have changed since then. This is not current legal advice or a production installation guide.

OpenSlides

You can have OpenSlides hosted commercially or run it yourself. I went for self-hosting, so here are the issues I ran into.

Installation

Back then there were Linux, Windows and Docker installation options. As I already had a Linux VPS, I chose Linux; the service had to be reachable from the internet so everyone could attend.

Two installation methods were available: PyPI and source code. I picked PyPI.

My original outline was:

#benötigte Pakete installieren
sudo apt-get install build-essential python3-dev python3-venv
#Verzeichnis erzeugen
mkdir OpenSlides
cd OpenSlides
# virtuelle umgebung erzeugen (optional)
python3 -m venv .virtualenv
source .virtualenv/bin/activate

#Openslides installieren
pip install openslides
#Openslides Starten
openslides

Those commands are from an old OpenSlides release. For current versions, use the official deployment documentation and secure the public-facing installation appropriately.

Configuration

In that version, configuration lived in ~/.config/openslides/settings.py.

One important setting was email, so the system could send invitations:

# Email settings
# For SSL/TLS specific settings see https://docs.djangoproject.com/en/1.11/topics/email/#smtp-backend
EMAIL_HOST = 'smtp.strato.de'
EMAIL_PORT = 587
EMAIL_HOST_USER = 'GeheinerMailUser'
EMAIL_HOST_PASSWORD = 'MegageheimesPasswort'
DEFAULT_FROM_EMAIL = 'wir@antworten.nicht'
EMAIL_USE_SSL=False
EMAIL_USE_TLS=True

The usernames, addresses and passwords in that example were just placeholders. Real SMTP credentials should be protected.

To make electronic voting available, it had to be enabled:

# Controls if electronic voting (means non-analog polls) are enabled.
ENABLE_ELECTRONIC_VOTING = True

Jitsi integration

OpenSlides also integrated with Jitsi. Participants could join the video conference from within OpenSlides, optionally automatically, and their names could be passed through.

That was a nice detail: one less thing for attendees to figure out.

The settings looked like this:

# Jitsi integration
JITSI_DOMAIN = 'meet.adminforge.de'
JITSI_ROOM_NAME = 'Milliways'
JITSI_PASSWORD = None

Keeping it running

At that stage, I was launching OpenSlides as an application, not a managed service.

My quick-and-dirty solution was to start it inside screen. That way, it kept running when I disconnected from SSH. I could reconnect later with screen -r.

For a real production deployment today, I'd use proper service management rather than depending on an interactive terminal session.

Multiple meetings on one server

If you want to run several separate meetings or instances on one host, I thought containers were the cleanest approach.

Preparing and operating a meeting

I planned to put the practical meeting tips in a separate post instead of making this one even longer.

Video conferencing

These were the resource lists and providers I collected at the time. Availability and privacy policies may have changed since 2020.

Jitsi instance lists

BigBlueButton servers and providers

Other links from my original list:

Not all of those services are necessarily still online. I kept the list as a snapshot of what was available when I was figuring out online club meetings.

Previous Next