Cover photo
The Linux Schools Project
478 followers|254,135 views


DHCP Reservations. This page has been improved for deleting and editing entries. Previously deleting an entry would have resulted in the DHCP service being restarted for each deletion which is very slow if you are deleting multiple entries and is even slower if you have an additional domain ...
Add a comment...

Re-Installing your main server

The current Karoshi server setup already has the option to restore data from an additional domain controller which is useful if you want to re-install your main server.

In the event that you don’t have an additional domain controller we now have an extra option that allows an automated restore for a new install from a backup archive. This only has essential data on the archive and is purely enough data to get the server up and running with samba4 fully restored and running. All user data would then have to be restored from a conventional backup.

The process is designed to be as painless as possible:

Choose the restore from archive backup option
Select your backup archive
Confirm that the servername and network details are correct
Change the root and administrator password

The screenshots in the archive shows the running through the new Karoshi restore option along with screenshots or restored users and a working web management.
krystal Marie's profile photo
Can you email me at
Add a comment...

Karoshi Server Version 11 released

Changes since version 10

Built on Ubuntu 16.04 LTS

ZFS is now installed from the official Ubuntu repositories

Choice of Install Types

The main server now has a set of four options for the installation.


This was the only option in Karoshi V10 and installs the main server with pre-defined student user groups which can be modified later. Suitable network shares for students and staff are created and can be added to later.


This installs without any student user groups. Suitable network shares for staff are created and can be added to later.


Installs with suitable groups and network shares for home use and MiniDLNA is automatically set up for a multimedia share.


This option is used to restore a previously installed server by using an Additional Domain Controller for re-joining to the domain. All users and gluster volumes are automatically restored.

Web Management

All of the Web Management has been converted to HTML5 and the style has been changed to having the navigation on the left. All information pages now have data sorting where appropriate.


DHCP now has fail-over support. If you have an additional domain controller applying the DHCP module will automatically set up the DHCP server on both of the domain controllers.


This is a new module that has been developed by one of my students that automatically downloads, installs and configures Gitlab ready for use one one of your servers.


Moodle has been updated to the latest version and now has moosh support so that any users that are created are automatically created in Moodle. This means that staff can assign students to courses without having to wait for students to log in to moodle.


The Owncloud module has been updated to 9.0.2 and uses the new format for connecting to user home areas.


The Joomla module has been updated to the latest version and now works with php7.


The radius module has been updated for correct configuration with Samba4.


The E-Mail module now has full access controls for all user accounts. Any user account can be set to full access, restricted ( the user can only send and receive E-Mail from a list of domains), receive only, send only, no access.
Add a comment...

Karoshi Server V11.0.1 is in beta

This new version of the Karoshi Server is built on Ubuntu 16.04 “Xenial” LTS.

New install options for the main server

We have realised for quite some time that Karoshi Server does not have to be for education and with that in mind we now have three install options for the main server.

Education – installs with standard education groups
Business – Installs without student year groups
Home – Installs with a multimedia share and minidlna auto configured

Testing and Updates

Testing is going well and the majority of problems have now been sorted out. Some of the recent changes have been documented below.

Samba Version 4.3.6

We now have a Samba 4.3.6 built for Xenial. This is a patched version to provide DNS round robin support which is missing from official samba builds. Our Samba version can be found at:

Owncloud Version 9

Owncloud has the ability to use external mounts for users which is really good for connecting up to user home areas. In Karoshi this is an automated process and changing where user home areas are stored also changes the Owncloud external mount configuration.

On updating the Owncloud module to  version 9 I found that external mounts are no longer configured in mount.json but are stored in the Owncloud database. Fortunately Owncloud has a command line option to import and export json format files. Unfortunately the json format has changed so we could not just import our existing json configuration which is auto generated as part of the logon script creation for for Windows, Linux, and Mac clients. With a bit of trial and error we now have support for creating and importing the json files.


Postfix changes were needed to stop postfix running in compatibility mode due to changes in Postfix version 3 configuration.


We use Yad for the initial Karoshi setup on the servers and ran into a problem on the latest beta with some of the yad boxes only displaying a title.

Yad boxes with --timeout option now also has to have the –timeout-indictator parameter set otherwise the box will not display anything.
Add a comment...

News Update

Sogo Sieve Support

The E-Mail setup has now been modified to provide Sieve support for Sogo via dovecot. This has involved changing the local delivery agent from postdrop to dovecot-mda. This enables vacation messages and E-Mail forwarding in Sogo.

OpenVPN module

The OpenVPN module was incorrectly setting the shorewall firewall configuration resulting in shorewall not restarting. This has now been fixed and will be released in the next patch.

Gitlab Module

The Gitlab module has undergone testing and is now ready for release in the next patch.

Web Management HTML 5 conversion

The conversion to HTML for the Web Management is now complete and ready to be released in the next patch.
Add a comment...

News Update

I have left out weekly from the title since I haven’t managed to post for a couple of weeks!

Samba 4.3.2

Samba 4.3.2 is now available from our Linux Schools staging repository for testing. This is the latest of the 4.3 series and although this is primarily for Karoshi V9 and V10 servers can be used by anyone wanting to run Samba 4 on Ubuntu 12.04 or 14.04.

Patch karoshi-web-controls-151209-1613

This patch is now available and provides the following changes:


We were having a problem with our internet slowing down at peak times on our proxy servers. An inspection of the logs showed “nf_conntrack: table full, dropping packet” . This message was being repeated many times in the logs.

As a result of this the patch sets nf_conntrack_max to 196608 for all proxy servers.

Configure Backup

This has been fixed for server names with hyphens

Internet Usage Trends

An Internet usage trends section has been added in the internet section of the web management.
This can be configured to search for any keywords that you want and gives a report showing internet usage for your users based on the keywords.

Update Server

The update server script now also checks to make sure that /etc/ssh_config has not been changed by an update.

Asset Register QR Codes

Asset register qrcodes now points to a new path that both admin and tech web management users can use. This has been changed so that any QR Code labels stuck onto assets around the school can be scanned and point to the relevant asset in the asset register.

Bulk User Creation

I made a change to this feature to allow special characters which also caused a problem with windows line returns. To fix this problem this patch installs dos2unix for dealing with windows line returns

Web Management

I have attempted to streamline the user section of the web management which was suffering from feature creep. The system section is next to receive some attention which will hopefully be improved for the next patch.
Add a comment...
Have them in circles
478 people
Ami Rojkes Dombe's profile photo
William Dale's profile photo
sas sh's profile photo
pyephyoe aung's profile photo
C Ros's profile photo
Tonico Strasser's profile photo
Koran Yellow's profile photo
Gabe Olowo's profile photo
Rusin Nikolov's profile photo

News Update

Samba 4.3.10

Samba 4.3.10 is now available if anyone needs it from the Linuxschools backports repository for Precise, Trusty, and Xenial.

Roaming Profile Control

The Web Management now has better roaming profile controls for setting if users are using a mandatory or roaming profile with Windows clients. Previously you could only set one user at a time to use a roaming which made it time consuming for controlling large groups of users.
Add a comment...
News Update

Samba 4.3.8

New versions for Samba 4.3.8 have been built for Precise, Trusty, and Xenial and are available from our staging repository. These are built from the samba source and have a patch added so that round robin works for DNS entries.


We have seen a few problems where students have set really easy passwords and then had their accounts used for sending spam. This is easy to spot after the event and the system warns of excessive E-Mail activity via an E-Mail alert and in the Web Management warning section. However at this stage it is a bit late as reputation is being affected for the domain. I am playing around with Postfwd to act as a policy daemon which is easy to automate a setup for and will rate limit incoming and outbound E-Mails. The only problem I have found is that the rule set requires “jump” rules to stop all rules being applied to all users which makes the config file more awkward to generate via the web management.

Distribution Server

Having done some testing on the distribution server for Karoshi V11 ( build on Ubuntu 16.04) I found that I could not network install Ubuntu 16.04 distributions at all. This has resulted in a redesign of the Distribution Server so that different netboots can be used for different Linux versions to give better compatibly.

Karoshi V11

Testing has been going well and I am hoping to have Karoshi version 11 released as close as possible to the official release of Ubuntu 16.04.

The main problem that has held up testing has been solved which was gluster volumes on top of zfs. The scenario that causes the problem was adding an additional domain controller to your main server which is coded to automatically set up a gluster volume for all critical data. The gluster volume is needed because samba does not currently do replication which is needed at least for the sysvol folder between domain controllers. Using gluster for this and having it available for any other data is really useful. The problem arises when you add a bunch of extra hard drives with a ZFS volume on them. The ZFS volume can be quickly created in the web management and the gluster volume data is automatically moved to the ZFS volume. The problem that arose was a timing problem when starting the server between the ZFS volume being available and gluster starting which if the order was wrong caused the gluster volume to not function correctly.
Add a comment...

News Update

Patch karoshi-web-controls-160222-1633 released

This patch provides the following changes:

Web Management

All of the web management has now been converted to HTML5.

A new page has been added to allow restricted distribution lists for E-Mail. This allows you to restrict sending of E-Mails to distribution lists to a limited set of users.

Documentation on this feature can be found at:

New Module

A Gitlab module has been added that allows you to install Gitlab on one of your servers .

Mac Support

Mac logonscript support added so that Mac clients can map the same network shares as the windows and Karoshi Linux clients.

Documentation on this feature can be found at:

Mail Server changes

Dovecot Sieve support has been added to enable support for Sogo vacation and forward messages. E-Mails are now delivered to users via dovecot-mda.


The Fail2ban configuration has been changed to correctly work with later Apache logging styles so that it correctly detects and bans failed login attempts.
Benjamin Chakaodza's profile photoThe Linux Schools Project's profile photo
if you go to you can register on our forum to get extra help and information.
Add a comment...

News Update

Web Management HTML 5 conversion

The web management was written to validate as HTML 4.0.1 Transitional. Over the Christmas holiday I was persuaded to convert it all to HTML 5. I am glad to say that this process is now nearly at an end. Even after automating as much of the change over as possible it turned out to be quite a grind to get through all of the pages. We now have a set of web management pages that validate as HTML5 but look just like they did before!

E-Mail groups – restricted to certain users

After adding in the dynamic groups feature which allows a quick way of creating E-Mail distribution lists I then found that I needed to stop students from being able to reply to E-Mails sent to these groups which started to cause internal spam E-Mails. This took some testing to sort out correctly to get the postfix rules correct but is now working and just needs a Web Management page added to control it so that it can go out in a patch.

Check System Updates

The Web Management will now show warning messages if any server in the system has not been updated in the last 10 days.
Add a comment...
Weekly Update

Gitlab Module

We are looking at using a versioning system for our students to use for Computer Science coursework projects. The easiest solution would have been to use github but this causes problems with student cousework which cannot be put in public view due to exam regulations.

I am fortunate in teaching some really talented and motivated students and Matthew Jowett volunteered to write a new module for Karoshi that would install gitlab on a chosen server.

The screenshots in the collection show Matthew's work on this module with gitlab running on a test server network and we are hoping to release this as a Karoshi module in the next patch.

Internet Usage Trends

This is an addition to the Internet section in the web management that allows Administrators to add categories to see user trends on internet usage. The trends are created from stored user internet logs. The aim of this feature is mainly to check for students that are consistently browsing for certain topics that could mean that there are concerns that need investigating.
Add a comment...
Have them in circles
478 people
Ami Rojkes Dombe's profile photo
William Dale's profile photo
sas sh's profile photo
pyephyoe aung's profile photo
C Ros's profile photo
Tonico Strasser's profile photo
Koran Yellow's profile photo
Gabe Olowo's profile photo
Rusin Nikolov's profile photo
Contact Information
Contact info
Linux for schools, both servers and clients
A Linux based operating system designed around the everyday needs of administrators of networks in education created and maintained by people who work in schools everyday.

Install a server or set of servers based on your school needs then administrate it via a web browser. Being a modular based system you can pick and chose from various server modules to install, choosing as few or as many as you like and mixing and matching modules depending on your preferences and environment.

We aim to provide :

  • Simple, secure web interface – Allowing you to control your network worldwide.
  • Configured modules, just click and go.
  • No license fees! The system and all of its features are free.
  • No need for in depth knowledge of Linux server administration.
  • The continued use of your current computers.
  • Windows and Linux compatibility.
  • The stability of being remastered from Ubuntu LTS.
  • Downloadable Source-Code hosted on GitHub

The Linux Schools operating system currently provides fully configured: 

Primary Domain Controller(Samba4), Additional Domain Controllers(Samba4), Active Directory, Groupware(SoGo), eMail(DoveCot/IMAP), E-Learning(Moodle), DHCP with failover, External Access to files(Owncloud), Website(Joomla), Printing(CUPS),Internet Proxy(Squid), Filtering(e2guardian with failover), Radius, Digital Signage(Xibo), Operating System Distribution, Reverse Proxy(NGINX), Monitoring with eMail and SMS alerts, Distributed Storage Systems(Gluster FS).

If there are any extra features you feel we should provide, please post them on the feature request section of the forum found here: Linux Schools Feature Request Board.