SearchCtrlK

Cancel

Service Manuals

Detailed parts and repair information for System76 hardware.

• System76 Tech DocsDiagrams and components for System76 hardware.

Contact Us

Can't find what you're looking for in our support articles? Our team is here to help.

• Open a Support TicketGet expert help from real support humans if you own a System76 computer.

Getting Started with Pop!_OS

• Accessibility

  Accessibility options for Pop!_OS

• Change Desktop Environment (Pop!_OS 24.04)

  Pop!_OS 24.04 Comes with COSMIC by default. Follow these instructions to install additional desktop environments.

• Default Apps in Pop!_OS

  Applications included in Pop!_OS 24.04

• Development Approach

  Learn about the Pop!_OS development methodology.

• Dock (Move or Customize)

  Move the Dock to different areas of the screen and customize.

• Installing Pop!_OS

  Full instructions on installing Pop!_OS your computer.

• Installing, Updating, and Removing Applications

  Quick guide to installing, updating, and removing apps on your device.

• Manage Repositories (Pop!_OS)

  Add, remove and edit repositories and sources in Pop!_OS

• Pop!_OS 22.04 LTS Keyboard Shortcuts

  Learn how master using Pop!_OS with your keyboard.

• Pop!_OS 24.04 LTS COSMIC Keyboard Shortcuts

  Learn how master using COSMIC with your keyboard.

• Pop!_OS Basics

  Learn how to navigate your new Pop!_OS desktop environment.

• Printer Setup (Pop!_OS)

  Here is how to add a printer in Pop!_OS.

• Recovery Partition

  Here is how to use the recovery partition to repair, refresh or reinstall your operating system.

• Upgrade Pop!_OS

  Upgrade to the newest version of Pop!_OS on your computer!

• Users (Manage User Accounts)

  How to add other users to your installation

• Using Flatpak from the Command Line (Pop!_OS)

  Using Flatpak from the Command Line

• Zoom-in or Enlarge Desktop

  Zoom in or enlarge your desktop interface.

System76 Hardware

• Access BIOS/UEFI or Boot Menu

  How to access BIOS/UEFI settings or boot from other media.

• Auto-Mount Second Hard Drive(s)

  Automatically mount additional hard drives.

• Battery Thresholds

  Set battery charging thresholds on your System76 laptop.

• Configuring Your New Launch Keyboard

  View, add, or modify keys in your OS.

• Creating Log Files

  Learn how to create log files for sending to System76 support

• Desktop Quickstart

  Getting started on your new System76 Desktop.

• Find Documentation For Your Model

  Diagrams and component guides for your System76 hardware.

• Firmware Flash to Clear the SMMSTORE ROM (Error code 5)

  How to fix the failed with exit status: exit code: 5 message

• Firmware Switching (Proprietary Firmware or System76 Open Firmware)

  How to transition from proprietary firmware to System76 Open Firmware on supported models.

• Flashing Firmware from a USB Flash Drive

  Flash firmware from a USB using a zip file provided by System76

• Graphics Switching (Pop!_OS)

  How to use systems with switchable graphics

• Install the System76 Driver

  Learn how to add the System76 Driver to your System76 computer after reinstalling Ubuntu

• Laptop Repackaging Instructions

  Step by step instructions for repackaging your laptop for repair or return

• Manual steps to update firmware on Launch and Launch Heavy keyboards

  Launch firmware before version 0.12.20 requires these steps to upgrade firmware with `fwupd`

• New Website Infrastructure

  A troubleshooting triage to help you self-diagnose a variety of issues.

• Replace the Thelio Power Button

  Here are a few easy steps to replace the power button in your Thelio.

• Serval DAC Clicking

  Certain models of the Serval WS will "click" when the DAC turns on and off, but the frequency can be decreased.

• Shipping Your Computer

  Instructions for preparing your computer for shipping to System76.

• System Fan Noise and Expectactions

  Ways to manage fan noise and design constraints.

• System76 Open Firmware Models

  A list of systems that run our Open Firmware and Open EC.

• System76 Server Setup

  Instructions on setting up a System76 server, including initial login credentials.

• Update System Firmware

  How to update System76 firmware.

• What is the Intel Management Engine?

  How to manually disable on systems running coreboot.

Media

• Gaming on Pop!_OS

  Set your system up for gaming!

• HDMI Audio Configuration

  Play audio over an HDMI or DisplayPort connection.

• HiDPI Multi-Monitor Support

  Mixing HiDPI and LoDpi displays on multiple monitors.

• Media Production (Pop!_OS)

  Learn about media production tools on Pop!_OS

• Raw Image Previews

  Add a custom thumbnail generator to display thumbnails for raw image in Files.

• Use AMD FidelityFX SuperResolution (FSR) on Pop!_OS

  Use AMD's FidelityFX SuperResolution to increase gaming performance.

• Watch Protected Content on Streaming Services

  How to view DRM-protected video content from online streaming services such as Netflix and Amazon Prime

• Watch Videos and Play Music (MP3, DVD, etc.)

  Enable playback of proprietary multimedia formats, such as MP3 files.

Software Troubleshooting

• Audio Troubleshooting Guide

  Here is how to fix several common audio issues with your computer.

• Bitesize Bugs

  Get started contributing quickly with bitesize bugs!

• Black Screen or Login Issues (Pop!_OS 22.04 LTS)

  Are you getting stuck in a login loop, even though your password is correct? Do you see a black screen after you log in?

• Black Screen Or Login Issues (Ubuntu 22.04)

  Are you getting stuck in a login loop, even though your password is correct? Do you see a black screen after you log in?

• Clear Cache and Cookies in Firefox and Chrome

  How to navigate to settings and delete browsing data in Firefox and Chrome.

• Closing Frozen Applications and Desktops

  Linux provides several methods to kill frozen or hung up processes and applications using GUI applications or terminal commands.

• Data Recovery

  How to back up your files if your operating system doesn't boot

• File Systems (Mount and Repair)

  How to mount and repair common file system issues.

• Guest User Only (After Initial Setup - Ubuntu)

  Sometimes, the first boot user creation fails and leaves only a Guest session. You can fix this by following the steps here.

• Log in from Live Disk (Chroot)

  Access an installed OS from a Live Disk/Recovery.

• Package Manager Issues (Pop!_OS)

  Here are ways to fix update, upgrade, and other package manager issues.

• Package Manager Issues (Ubuntu)

  Here are ways to fix update, upgrade, and other package manager issues.

• Pop!_OS Incomplete Upgrade

  What to do if your upgrade is incomplete or not working correctly

• Repair the Bootloader

  How to repair and reinstall the bootloader.

• Software Troubleshooting Triage

  A troubleshooting triage to help you self-diagnose software issues.

• VirtualBox Black Screen on Threadripper Platforms (Solution)

  How to enable video output in VirtualBox guests on hosts using Threadripper or Threadripper Pro CPUs.

Network Troubleshooting

• Bluetooth Troubleshooting

  Here is how to fix several common Bluetooth issues with your computer.

• Networking Diagnosis (TCP/IP Stack)

  Instructions on how to help diagnose networking issues.

• Wireless Troubleshooting

  If your computer can’t connect to wireless networks or the connection is unstable, use this guide to diagnose and resolve the issue.

Hardware Troubleshooting

• Diagnose Hardware Failures

  If the computer won't start, boot, or otherwise operate normally, there may be a hardware issue. Follow these steps to diagnose hardware failures.

• Freezing Systems

  Troubleshoot if your system is freezing

• Live Disk Creation

  Create and use bootable media to install or repair your OS.

• Live Disk Creation (Pop!_OS)

  Create and use bootable media on Pop!_OS.

• Power on Failure - Desktop

  Troubleshoot if your Thelio is not powering on

• Power on Failure - Laptop

  Troubleshoot if your Laptop is not powering on

• Reboots (Unexpected)

  If your system is spontaneously rebooting, this article provides steps to isolate the cause.

• Webcam

  Activate and troubleshoot your laptop webcam

Software Installation and Tips

• Active Directory Domain

  Learn how to join Pop!_OS to an Active Directory domain

• Back Up Files

  Guidelines and tips for making backups of your important files.

• Change User Password and LUKS Passphrase

  Forgot your main password? Locked out of your computer? Need to change your encryption passphrase? Follow these instructions to change both!

• Containers on Linux

  How to setup and use LXC/LXD

• CUDA and cuDNN (Install)

  Complete instructions on setting up the NVIDIA CUDA toolkit and cuDNN libraries

• Disk Encryption Passwords

  How to add extra passwords for your Full Disk Encryption setup

• Enable Hibernation (Suspend to Disk)

  How to partition your drive and set up hibernation in Pop!_OS.

• Encrypt Extra Drive

  Encrypt Extra Drive(s)

• File Sharing Between Pop!_OS Computers

  How to share files with the Public Folder.

• Format Your Drive

  Learn how to format your drive

• Graphics Switching (Ubuntu)

  How to use systems with switchable graphics

• Install and Use Tensorman

  Use Tensorman to manage TensorFlow containers.

• Install and Use VPNs

  Set up and use OpenVPN to browse the internet more securely in places like airports, cafe shops and more.

• Install Pop!_OS in VirtualBox

  Install Pop!_OS in a virtual machine like VirtualBox

• Install ROCm

  Instructions for setting up ROCm for HIP & OpenCL workloads on AMD GPUs

• Installing Julia in Pop!_OS

  Install the Julia programming language in Pop!_OS.

• Keep PPAs Enabled when Upgrading Releases

  How to keep your PPA or third party repo enabled during upgrades.

• Kernelstub Usage

  Add or change kernel and boot parameters using kernelstub

• Lightworks (Install - Pop!_OS 22.04 LTS)

  Complete instructions on installing Lightworks

• Manage Repositories (Ubuntu)

  Add, remove and edit repositories in Ubuntu

• Manually Disable the ProtonVPN Permanent Kill Switch

  How to manually disable the ProtonVPN permanent kill Switch after refreshing Pop!_OS.

• MATLAB (Install - Pop!_OS 20.04 LTS)

  How to install MATLAB

• Minecraft Server (Install & Host)

  So you want some of that blocky goodness? Well, get Java and some graphics cards and let's go!

• Run Windows Programs in Pop!_OS Using Bottles

  How to run Windows-only programs in Pop!_OS using Bottles.

• Set Up E-Mail

  How to configure email services like ProtonMail with Geary

• System76 Software (Install - Other Operating Systems)

  Learn what software is needed to use other OSes and install them

• Upgrade Ubuntu

  Get the newest version of Ubuntu on your System76 computer! Check out our upgrade directions.

• Using Legacy Status Icons in Pop!_OS

  Use legacy status icons (system tray/AppIndicators) with a GNOME extension

• Using Pop Shell on other GNOME Desktops

  Learn how to build Pop Shell from source.

• Windows (Install)

  Instructions for installing Windows on System76 hardware or within a virtual machine, and for locating Windows drivers.

Hardware Configuration

• Battery Life Improvements

  Stretch the battery life and create amazing things for longer.

• Microphone Use

  Here is how to enable and adjust the microphone.

• Mouse Customization

  How to customize the buttons on your mouse

• Touchpad (Configure or Disable)

  Learn how to turn on and configure touchpad functions.

Switching To Linux

• Bash Scripting Basics

  Creating scripts using Bash.

• Creating Virtual Machines in Linux

  Create a VM on Linux with GNOME Boxes or Virtual Machine Manager

• Differences between Pop!_OS and Ubuntu

  Discover the differences between these two Operating Systems

• Find Command Help Using the Terminal

  Using apropos, whatis, info, man, and --help to find appropriate commands and command usage information.

• Linux Terminal Basics

  Linux offers users a lot of flexibility. Use the terminal to accomplish tasks faster

• Transferring Photos From Your Phone to Pop!_OS

  How to move your photos from your Android or iPhone to Pop!_OS

Getting Started with Ubuntu

• Install Ubuntu

  Full instructions on installing Ubuntu your computer.

• Printer Setup (Ubuntu)

  Here is how to add a printer in Ubuntu.

• Ubuntu Basics

  Learn how to navigate your new Ubuntu desktop environment with a few easy tips.

• Ubuntu Keyboard Shortcuts

  Learn how master using Ubuntu with your keyboard.

Community Articles

The following documents have been graciously submitted by community members. They have not been checked for accuracy, completeness, or style. Please contact the contributors through their GitHub accounts for any questions.

• Drives - Map a Network Drive

  Map a network drive using Files in Pop!_OS.

• Install and Play Luanti

  Luanti, formerly Minetest, an open source infinite-world block sandbox game with survival and crafting.

• Install cjdns

  Connect to the meshnet! Cjdns uses an ipv6 allocated space public key encrypted routing system to protect privacy.

• Install Minecraft Server

  Install Minecraft Server and play with your friends!

• Install Minecraft!

  So you want some of that blocky goodness? Well, get Java and some graphics cards and let's go!

• Install OpenSpades

  Use Snap or build OpenSpades from source to enjoy a voxel-based first person shooter.

• Login with Yubikey

  Configure Pop!_OS to accept a Yubikey for login and unlock.

• Modify Keyboard Shortcuts (Pop!_OS)

  View, add, or modify keyboard shortcuts in Pop!_OS.

• Numba (Install - Python3)

  Complete instructions on setting up the Numba library in Python for fast, parallel computing using the NVIDIA CUDA toolkit.

• Setup facial recognition for authentication (howdy).

  Want to forever forget about typing in a sudo password?

Case Studies

• Advancing Biosustainability at the Technical University of Denmark

  Developing metabolic engineering, robotics, and lab automation tools.

• Augmented Reality Sandbox

  Calibrate and use your new AR Sandbox

• Bioinformatics at Johns Hopkins University

  Using Linux computers for bioinformatics education and scientific data analysis.

• Conducting Collaborative Oceanographic Research

  Marine biology expeditions, powered by Linux.

• Deep Learning Research at the University of Colorado

  Systems administration and IT support for deep learning researchers.

• Developing Desktop Applications at CodeWeavers

  Growing Linux on the desktop with CrossOver.

• Web Application Development at Eficent

  Developing and deploying web applications with Linux.

• Web Design and Site Management at Mallee Blue Media

  Web development, content marketing, and conversion optimization with Linux.