Libre Workspace

Website

Documentation

Download

Libre Workspace

• Your data stays with you
• Cloud for files, calendars, Office, chats, conferences ...
• Open source by definition

Technical Information

Libre Workspace consists of a set of software packages which should implement a modern cloud infrastructure for small companies or individuals. It is based on the following software:

• Debian as the operating system
• Samba DC as the domain controller and Active Directory implementation
• Libre Workspace Portal as the central management software for the Libre Workspace
• Nextcloud as the cloud storage solution with integrated groupware
• Jitsi Meet as the video conferencing solution
• Matrix as the chat solution (with element as the web client)
• BorgBackup as the backup solution
• Extendable with addons

How to install

https://docs.libre-workspace.org/setup/installation.html

(Otherwise you can see the installation in /docs/setup/installation.rst)

🎞️ Video Tutorial Series (in German) 🎞️

https://www.youtube.com/watch?v=tzs9SdfeOMc&list=PL26JW41WknwissQLa5JSEnGui9rHppYXB

Technical Information for Developers

Make sure to check the documentation in /docs or at https://docs.libre-workspace.org/

Build .iso

sudo apt install syslinux-utils git xorriso
git clone https://codeberg.org/Libre_Workspace/libre-workspace
cd libre-workspace
bash download_debian_iso.sh
bash build_deb.sh
sudo bash build_iso.sh

You can access the installer at port 80 and 443. (After installing the debian base system). Your default account is called "Administrator".

How to develop

# Make sure on your dev machine no actual libre workspace component is installed.
# Start from this directory
sudo apt-get install libldap2-dev python3-venv libsasl2-dev python3-dev docker.io caddy
# If you are running your dev machine on an arch based system this would be the relevant command:
# sudo pacman -S openldap cyrus-sasl caddy gcc python borg python-llfuse rsync zip cronie unzip sudo git curl gettext ldb whois
sudo usermod -aG docker $USER
sudo usermod -aG www-data $USER
# (Reboot your computer to apply the user group changes)
sudo mkdir -p /var/www/libre-workspace-static
sudo chown -R $USER:$USER /var/www/libre-workspace-static
sudo ln -s $PWD/src/etc/libre-workspace/ /etc/libre-workspace
sudo ln -s $PWD/src/usr/lib/libre-workspace /usr/lib/libre-workspace
mkdir -p $PWD/src/var/lib/libre-workspace/portal/history
sudo ln -s $PWD/src/var/lib/libre-workspace/ /var/lib/libre-workspace
sudo mkdir -p /var/www/libre-workspace-wordpress
sudo chown -R $USER:$USER /var/www/libre-workspace-wordpress
cd /var/lib/libre-workspace/portal
python3 -m venv venv
cd -
cp /etc/libre-workspace/portal/portal.conf.example /etc/libre-workspace/portal/portal.conf
vim /etc/libre-workspace/portal/portal.conf # Configure
cp /etc/libre-workspace/libre-workspace.env.example /etc/libre-workspace/libre-workspace.env
# If you did the setup above once, you can start the django server with this command
bash run_development.sh
# Start unix service (in a second terminal session)
cd src/
bash usr/bin/libre-workspace-service
# To clean later your computer after ending the development:
sudo rm -rf /var/www/libre-workspace-static
sudo rm /etc/libre-workspace
sudo rm /usr/lib/libre-workspace
sudo rm /var/lib/libre-workspace
sudo rm -rf /var/www/libre-workspace-wordpress

Start a new django app

cd /usr/lib/libre-workspace/portal
. /var/lib/libre-workspace/portal/venv/bin/activate
python3 manage.py startapp my_new_app

Access django shell

. /etc/libre-workspace/portal/portal.conf
cd /usr/lib/libre-workspace/portal
. /var/lib/libre-workspace/portal/venv/bin/activate
python3 manage.py shell

Build documentation

The documentation is also accessible at https://docs.libre-workspace.org/

sudo apt install python3-sphinx python3-sphinx-rtd-theme
bash build_docs.sh

You find the generated html files in docs/build