Canonical URL: https://www.qubes-os.org
This is the main repository for the Qubes OS Project website. Qubes is a security-oriented, open-source operating system for personal computers. It uses virtualization to implement security by compartmentalization and supports both Linux and Windows virtual environments.
Qubes OS is free and open-source software. If you rely on Qubes for secure computing in your work or personal life, or see the value in our efforts, please consider making a donation today.
This repository consists of a Jekyll site and several Git submodules for content:
qubes-doc
(official documentation)qubes-attachment
(binary files such as images)qubes-hcl
(Hardware Compatibility List (HCL) reports generated by a YAML version ofqubes-hcl-report
)qubes-posts
(news and blog posts)
These instructions have been tested on a Fedora 33 qube. Podman is not available in Debian 10. You must use a Fedora-based machine or Debian 11.
-
Install
podman
andpodman-compose
. -
Start the Podman daemon, e.g.:
$ sudo systemctl start podman
-
Clone this repo, including all submodules, and enter it:
$ git clone --recursive https://github.com/QubesOS/qubesos.github.io.git $ cd qubesos.github.io/
-
Start and run the website:
$ sudo make
-
Open your browser and navigate to:
http://127.0.0.1:4000/
-
To update the submodules, use
git submodule foreach git pull --tags
. -
For troubleshooting with RubyGems, see: http://guides.rubygems.org/
-
For troubleshooting with Jekyll, see: https://jekyllrb.com/docs/home/
-
For troubleshooting with GitHub pages and Jekyll, see: https://help.github.com/articles/using-jekyll-as-a-static-site-generator-with-github-pages/
-
To run on a Git post-receive hook, use:
GIT_REPO=/usr/home/git/repositories/www.qubes-os.org.git GIT_CLONE=/usr/home/git/tmp/www.qubes-os.org PUBLIC_WWW=/usr/local/www/qubes-os.org/www/ if [ ! -d "$GIT_CLONE" ]; then git clone --recursive $GIT_REPO $GIT_CLONE else git --work-tree=$GIT_CLONE --git-dir=$GIT_CLONE/.git pull fi cd $GIT_CLONE && jekyll build -s $GIT_CLONE -d $PUBLIC_WWW find $PUBLIC_WWW -type f -print0 | xargs -0 chmod 666 find $PUBLIC_WWW -type d -print0 | xargs -0 chmod 777 exit
To contribute to the documentation, please see how to edit the documentation.
- Jekyll Documentation - template rendering engine
- Bootstrap 3 - styling and CSS structure
- FontAwesome - the icon font throughout the site
- jQuery 1.7 - javascript helper library
- jQuery ToC MD Generator - renders header menu on documentation section
- qubes-os.org-3.2-EOL.zip contains the state of the Qubes website when Qubes OS 3.2 reached EOL. All you need to browse it is a web browser.
- Here is the state of this repo and all submodules when Qubes OS 3.2 reached
EOL:
- https://github.com/QubesOS/qubesos.github.io/tree/3.2-EOL
- https://github.com/QubesOS/qubes-doc/tree/3.2-EOL
- https://github.com/QubesOS/qubes-hcl/tree/3.2-EOL
- https://github.com/QubesOS/qubes-posts/tree/3.2-EOL
- https://github.com/QubesOS/qubes-attachment/tree/3.2-EOL