Need help with docs?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

247 Stars 333 Forks 3.3K Commits 36 Opened issues


System76 support documentation site

Services available


Need anything else?

Contributors list

System76 Support Docs

The docs system is powered by NuxtJS with

, tailwindcss, and some other packages. It uses Markdown in the

folder to render every article. If you don't know what Markdown is (or need a refresher), take a minute to look over the basics.

Adding Articles

All articles are stored as Markdown files under

. For example, take a look at the

To create a new support article, click the + icon at the top of the


Name the file something short but descriptive. This will be part of the URL, for example
will become Don't use spaces; instead, use dashes (

Then include the following text at the very top of the file (including the

title: Do the thing
description: >
  A more descriptive sentence or two about the page; will show up in search
  engines and on the support home page.
  - List
  - of
  - keywords
  - about
  - this
  - page
  - System76

facebookImage: /_social/article twitterImage: /_social/article

hidden: true section:

A couple of notes:

  • After the

    line, you can type the contents of the article in markdown. Feel free to use
    # Heading1
    ## Heading2
    , and other markdown to make the page look awesome.
  • For keyboard shortcuts, use the HTML tag

    , i.e.
  • The default publication status is set to

    hidden: true
    . To make your article visible, change the
    hidden: true
    hidden: false
    in the top of the file.
  • To make your article visible within a section, write the section name in the

    line. For instance, to add an article to the "Switching to Linux" section, the line should be
    section: switching

When you're all done, fill out the "Commit new file" form at the bottom with the description of your changes and press the "Commit changes" button.

Editing an Article

To edit or update an article, click on the article's file in GitHub. Then click the pencil "Edit this file" icon on the top-right. You can now edit the contents right on GitHub. To see what it will look like before you save it, click the "Preview changes" tab at the top.

When you're all done, fill out the "Commit changes" form at the bottom with the description of your changes and press the "Commit changes" button.


Articles will only show up under the section they are configured for. If you set

hidden: true
in an article, it will not be visible on any of the index pages, and you will need to know the direct URL to view it.

If you want an article to not show up on the index page, but be visible on

, set
hidden: false
and remove the
line from the article.

To get an article to show up under Frequently Answered Questions, set

section: faq

To get an article to show up under Known Solutions, set

section: solutions

To get an article to show up under Articles, set

section: articles

Files, Images, and Links

To store files (i.e. BIOS updates), put them in the

folder. If it's a BIOS/fireware update, it goes in the
folder and should be named like
, i.e.

Anything in the

folder will be available at the base URL. For instance,
will be downloadable at

When linking to files, please use the absolute path, i.e.



The Ubuntu logo can be included in a doc using the following HTML tag:

You can embed this in other Markdown and Tags, for example, you can create an Pop!_OS (Super) key:


Local Development

This site is built with NuxtJS and

. To get started, you will need to clone this repository to your local computer.

Next, you will need to setup

14 <=
. The nodejs website has great documentation on how to do this.

After that, you can run

npm ci
to install the needed packages, and
npm start
to start the development site. You will then see a
line in your console showing where you can access the development site.

To deploy changes, simply make a PR to the

GitHub repository and once it's merged, it will be deployed to the live site!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.