Skip to content

Abitti Disk Image is a collection of Linux distributions maintained by the Finnish Matriculation Examination Board.

Notifications You must be signed in to change notification settings

digabi/digabi-os

Repository files navigation

Digabi logo

Digabi is a codebase used in the Abitti exam system, the digital exam environment for the Finnish Matriculation Examination.

All bug reports, feature requests, and pull requests are appreciated. However, the following should be kept in mind:

  • Pull requests based on submitted issues cannot be implemented due to limited resources. Similarly, upstream issues related to third-party projects in use are not forwarded.
  • No guarantee can be given that submitted pull requests will be reviewed.
  • Our focus is strictly on the Finnish Matriculation Examination, as defined by law. Issues or pull requests unrelated to this mission will not be addressed.
  • Official channels should be used for inquiries. The issue tracker and pull requests are not to be used for general questions or support requests.

Before any contribution is accepted to the codebase, to clarify the intellectual property rights associated with contributions to open-source projects owned by the Finnish Matriculation Examination Board, all contributors must sign and submit a Contribution License Agreement (CLA):

Digabi 1 (DigabiOS)

The current Abitti 1 version runs on Debian Linux. The end-of-life of the underlying DigabiOS distribution will happen after the test days in spring 2026.

In Digabi 1, test takers start their laptops from USB sticks and the servers run in a similar fashion. You can run the server as VirtualBox VM. For this, we have an end-user helper application, Naksu.

While Debian GNU/Linux is itself based on open source, the Abitti exam system is not. Also, the disk image contains 3rd party software with separate licenses. All end-user licenses and the record of processing activities can be found at Abitti.fi.

If you are providing applications to Abitti 1 you might want to take a look at the instructions how to tinker Digabi 1 (DigabiOS).

Distributions

  • The client distribution runs on candidates’ devices
  • The server distribution runs on exam arrangers’ devices

Documentation

For documentation, see doc/*.md. Manual for live-build toolset: Debian Live Manual.

How to build

To get an overview of the building process see doc/building.md. However, while this repository contains the code required to build the kernel and the image the complete Abitti image contains packages from various sources.

Sources

DigabiOS is not an open source project. The DigabiOS contains binary packages from various sources:

  • DigabiOS uses GNU/Linux kernel obtained from Debian source packages. The source kernels are as-is except a one-line patch that disables booting with an arbitrary initrd. The patched kernel sources can be found at https://static.abitti.fi/kernel-sources/index.html.
  • Most of the binary files in the image are unchanged Debian packages. The package owning a file can be queried using the standard Debian tool dpkg. The sources of these unchanged packages are provided by the Debian project. The sources of changed GPL licensed packages can be found at https://static.abitti.fi/patched-sources/index.html.
  • The DigabiOS contains closed source software. The MEB has signed license agreements with the respective parties and further gives Abitti users rights mentioned in the Abitti license agreement.
  • The Abitti exam system, which in this case means code showing the exam questions, material and recording the test takers’ submissions is owned by the MEB. It is licensed according to the aforementioned Abitti license agreement. Some modules are open source, see https://abitti.net.

Disclaimer

The source code is released here on grounds of transparency. The maintainers of the repository do not actively investigate pull request or issues. To contact MEB regarding this repository, please use the address abitti@ylioppilastutkinto.fi.

MEB reserves the right to revise the content of this repository without prior notice.

All use of the content of this repository is done at one's own risk.

About

Abitti Disk Image is a collection of Linux distributions maintained by the Finnish Matriculation Examination Board.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 34