All about the Wiki.
The wiki is powered by Gollum

All pages

See all pages at once.


How to read the Wiki

The wiki is divided into 4 main areas:

  1. Desktop
  2. Server
  3. Mobile
  4. PwOSS

In each section, the respective tutorials and explanations are listed.


How to create/change Wiki pages

Please read the entire page before adding or changing any pages!


PwOSS - Gitea account

To create or change wiki pages, you first need an account at PwOSS - Gitea. See the Wiki page - Gitea for more explanations about Gitea, including instructions on how to Fork the wiki and create a Pull Request. Which is important to create or change wiki pages!



The root folder

root Description
content inlcudes all "organizations"
deprecated to keep unused pages
public includes all assets (images, css, fonts,...)
LICENSE Wiki license Gitea/git README file listed ALL pages of the wiki
custom.css design of the wiki the main wiki page




Organizations Description
desktop includes the Arch installation
mobile includes Android, Linux content and an file
pwoss includes all about pwoss
server includes all the tutorials about the x86_64 server




The desktop is really simple.
Just an file, and the



This section is outdated and needs to be reviewed.

Mobile is in general a tough fight. Not only the flashing process, also the how to.

At first we have an which covers all content from the android folder. We have also added an file if someone is able to create some privacy ideas about Apple. Since February 2020 we also include Linux installations.


The Android folder covers the entire installation process and contains some information about Android in general.

The devices folders are tutorials for specific phones.



Contains everything about PwOSS like this Wiki how to.


This section is outdated and needs to be reviewed.

Contains every tutorial and the list of the,, and



Unused pages can be moved to this folder.



This section is outdated and needs to be reviewed.

Usually only the image folder is important. Why is described below.


Wiki explanation

Before you start changing any pages, you need to know how the wiki works.
All pages are mainly located in the content folder. As described above. If necessary, create a new folder.

This covers the basics and some PwOSS rules.
The full description are avilable at


Footer, Header & Sidebar

Every folder contains a file, but ...

... do NOT add a, or file to the root folder! It overwrites all other, or created in other folders. It is a global, or option. Which isn't really helpful.


custom.css & custom.js

Any Pull Requests of these files will be rejected. Security concerns.


Internal links

If you want to link to another wiki page, please use [another wiki page](/content/organization/

Do NOT use the whole URL. This makes it much easier if you Fork the wiki and want to use it on your computer or if others want to use it on their computers. Otherwise, they will be redirected to




Please add all images under /public/images/ and create a new folder if necessary.


  1. [[/public/images/path/to/your/image.png|alt=text]]
    • Text to display when the image is not found.
  2. [[/public/images/path/to/your/image.png|frame]]
    • Tells Gollum to place the image in a <span class="frame">, which will display a border around the image.
  3. [[/public/images/path/to/your/image.png|align=position]]
    • Tells Gollum to align the image in the given way. Position can be left, center, and right. Default: left.
  4. [[/public/images/path/to/your/image.png|float]]
    • Tells Gollum to float the image so that the text flows around it. This option can not be used with the align=center option. When floating is enabled and alignment is not specified, align=left is applied.
  5. [[/public/images/path/to/your/image.png|height=value]]
    • Set maximum height for the image. Values must be specified either with px or em unit.
  6. [[/public/images/path/to/your/image.png|width=value]]
    • Set maximum width for the image. Values must be specified either with px or em unit.


Table-of-contents (TOC) tag

The tags triggers the TOC. The reason for the image.


Install Wiki on your local computer

This makes it easier for you if you want to change some pages or create new ones. You can check the changes before starting a pull request. You can also use it for your own needs.



sudo pacman -S ruby ruby-rdoc cmake git
mkdir -p ~/your/wiki/path
git init ~/your/wiki/path
gem install gollum
gem install github-markdown

Update gollum

gem update


Copy config files

Copy config.rb, public and the templates into your wiki.

cp ~/.local/share/gem/ruby/2.7.0/gems/gollum-5.*/config.rb ~/your/wiki/path/config.rb
cp -r ~/.local/share/gem/ruby/2.7.0/gems/gollum-5.*/lib/gollum/public/gollum ~/your/wiki/path/public
cp -r ~/.local/share/gem/ruby/2.7.0/gems/gollum-5.*/lib/gollum/templates ~/your/wiki/path/public/templates



Create a service to run it on every boot.

sudo nano /lib/systemd/system/gollum.service
Description=Gollum wiki server

ExecStart=/bin/bash -c "PATH=/home/USER/.local/share/gem/ruby/2.7.0/bin:$PATH exec gollum --config /home/USER/your/wiki/path/config.rb --template-dir /home/USER/your/wiki/path/public/templates/ --css" 

sudo systemctl enable gollum.service && sudo systemctl start gollum.service


Push from local desktop folder to git

Create a file, add images, etc. and add your description.

After you have added your content, you need to run the following commands in your Wiki root directory:

git add .
git commit -m "your explanation about the content, changes ..."


Switch to PwOSS - Wiki


Clone Wiki

cd /home/user/pwoss/path/to/the/
git clone


Change gollum.service

sudo nano /lib/systemd/system/gollum.service
Description=Gollum wiki server


# your-wiki
#ExecStart=/bin/bash -c "PATH=/home/USER/.local/share/gem/ruby/2.7.0/bin:$PATH exec gollum --config /home/USER/your/wiki/path/config.rb  --template-dir /home/USER/your/wiki/path/public/templates/ --css"

# PwOSS - Wiki
ExecStart=/bin/bash -c "PATH=/home/USER/.local/share/gem/ruby/2.7.0/bin:$PATH exec gollum --config /home/USER/your/wiki/path/config.rb --template-dir /home/USER/pwoss/path/to/the/Wiki/public/templates/ --css"


sudo systemctl daemon-reload && sudo systemctl restart gollum


Nginx (Wiki network)

If you want to run the Wiki on your network/server.

sudo nano /etc/nginx/sites-available/gollum
upstream gollum_app_webrick_server {
    server localhost:4567;

server {
        listen 4444;
        server_name your-ip;
#        return 301 https://your-domain$request_uri;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Scheme $scheme;
        proxy_redirect off;

        proxy_pass http://gollum_app_webrick_server;
sudo ln -s /etc/nginx/sites-available/gollum /etc/nginx/sites-enabled/
sudo systemctl restart nginx.service



If you have UFW installed.

sudo ufw allow 4444/tcp



Create the file custom.css in your root repository.

touch ~/your/wiki/path/custom.css


Size of Gollum

Change the size of the wiki.

nano ~/your/wiki/path/custom.css
.container-lg {
  max-width: 70%;
sudo systemctl restart gollum.service