aboutsummaryrefslogblamecommitdiffstats
path: root/builds.sr.ht/compatibility.md
blob: ea1db18453c93089d4aaec1a9c4af8ea6fb532c7 (plain) (tree)
1
2
3
4
5
6
7
8



                                        

                                                                                

                                                                            


                                                                           



                                                                              

                     



                                                                              
                                                                                 
                                                    



                                                                              

                            

               

                                        

                                                                                   
                                          

         
                          







                                                                      



                      



                                                                                                      



                                                           

                    
                                                                                                  





                                          
                          

                                                                      
                                       


























                                                                                                      
                          
                                                                      
                                                          
                                       









                                                   



                                                                                                      





                                                           
                                                                                                  





                                          
                          
                                                                      
                                                           
                                        









                                                   



                                                                                                      



                                                           
                     
         
                                                                                                  


          


                                          
                          
                                                                      
                                                           
                                         









                                                   



                                                                                                      



                                                           
                     
         
                                                                                                  


          





















                                                                               

             

                                        

                                          
        



                                                                      

         



                                                   
         






                                                           
         


          










                                                                              

         
                                        
 

                                                                       
 

                                          
        
                                     
                                                                      
                                                             
                                         
           

         



                                                   
         

          
                                                                                                    




                                                           
         







                                                                                                       




                                          
        
                                        
                                                                      
                                                              
                                           
           

         



                                                   
         

          
                                                                                                    




                                                           
         







                                                                                                       




                                          
        

                                                                      

                                                               
           

         



                                                   
         


                              
                                                      


                                              
         




                                                           
         





                                                                                                       


































                                                                                                       

                                                                                                      


          















                                                                                

         

                                                         


                                          
                             
                                                                      
                                                              
                                     









                                                   

                                                                                                      











                                                           
                        

                                                                      
                                     























                                                                                                      
                        
                                                                      
                                     









                                                   

                                                                                                      








                                                           







                                                          
       








                                                     

          

                                           


                                                           

                                          
        
                           
                                                                      
                                                              





























                                                                                                        
                                        
           

         



                                                   
         

          
                                                                                                      



                                                           
                     
         



                                                                                                        





                                          
                           
                                                                      
                                        









                                                   
                                                                                                      



                                                           
                     
         



                                                                                                        


          



                                                   


                                                                           



                                                                






















































































                                                                                                        

        

                                             


                                                                                

                                          
        
                          

                                                                      
                                       
           

         



                                                   
         

          


                                                                                                      




                                                           
         




                                          
        



                                                                      

         



                                                   
         

          


                                                                                                      




                                                           
         

          


            
                                                                          
                                                                                
              


                


















                                                                                      
 



                                          


                                                                                


                                          
                          
                                                                      
                                                              
                                       

























                                                                                                       
                                                                                                      






                                                                                                      
                          
                                                                      
                                       









                                                   
                                                                                                    





                                                           










                                                                                                       




          
                                                               








                                                                

















































                                                                                                      

         
                                                  
 


                                                                                               



                                          
                                   
                                                                      
                                                          

                                                            









                                                   
                                                                                                    



                                                           

                     


                                                                                                      


          


                                          
                                    

                                                                      

                                                             





















































                                                                                                      














                                                                               




                                        

                                                        































                                                                                
---
title: builds.sr.ht compatibility matrix
---

If you have any special requests, please [send an
email](mailto:~sircmpwn/sr.ht-discuss@lists.sr.ht). Only architectures supported
by each Linux distribution upstream are listed, and named after the upstream
port (e.g. Debian uses "amd64" while Alpine uses "x86_64").

**Note**: support for multi-arch builds is underway, but not yet available.

The "native" column is checked if these builds run on native hardware for that
architecture, if unchecked the builds are run on emulated hardware and may
suffer from poor performance.

**Support lifecycle**

The support lifecycle for each build image follows the upstream support cycle.
Each supported upstream release is generally offered on sr.ht, as well as the
bleeding edge or development releases if applicable. No sooner than two weeks
after a release becomes unsupported upstream, it will be unsupported on
builds.sr.ht — and anyone who's submitted recent builds using those images will
get an email warning them of the impending breakage.

It's recommended that you use aliases like "alpine/latest" or "debian/testing"
rather than using a specific release in your build manifests.

<div class="clearfix"></div>

## Alpine Linux

Maintainer: Drew DeVault <sir@cmpwn.com>

Support policy: [upstream](https://wiki.alpinelinux.org/wiki/Alpine_Linux:Releases)

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Alpine Edge</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: alpine/edge</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
    <tr><td><code>arch: x86</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Alpine 3.14</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: alpine/latest</code> <strong>or</strong>
        <code>image: alpine/3.14</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: x86</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Alpine 3.13</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: alpine/old</code> <strong>or</strong>
        <code>image: alpine/3.13</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: x86</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Alpine 3.12</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: alpine/3.12</code> <strong>or</strong>
        <code>image: alpine/older</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: x86</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Alpine 3.11</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: alpine/3.11</code> <strong>or</strong>
        <code>image: alpine/oldest</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: x86</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

**packages**

The packages array is installed with `apk add`.

**repositories**

To add custom apk repositories, use `repo-url key-url key-name` (separated with
spaces), where `repo-url` is the URL of the package repository and `key-url` is
a URL from where the signing key may be downloaded, and `key-name` is the name
of the file written to `/etc/apk/keys/`. If the name of the repo is prefixed
with an @, it will use that prefix in apk.

Example:

```yaml
repositories:
  sr.ht: >
    https://mirror.sr.ht/alpine/sr.ht/
    https://mirror.sr.ht/alpine/sr.ht/alpine%40sr.ht.rsa.pub
    alpine@sr.ht.rsa.pub
```

## Arch Linux

Maintainer: Drew DeVault <sir@cmpwn.com>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Arch Linux</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: archlinux</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
  </tbody>
</table>

**packages**

The package array is installed with `yay -Syu` (AUR packages are transparently
installed).

**repositories**

To add custom pacman repositories, use `url#key-id`, where `url` is the URL of
the package repository and `key-id` is the ID of the published PGP key the
packages are signed with.

## Debian

Maintainer: Drew DeVault <sir@cmpwn.com>

Support policy: stable, testing, unstable, and oldstable are supported.
See also: [upstream releases](https://www.debian.org/releases/)

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Debian Buster (stable)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: debian/stable</code> <strong>or</strong>
        <code>image: debian/buster</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: armel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhl</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipsel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Debian bullseye (testing)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: debian/testing</code> <strong>or</strong>
        <code>image: debian/bullseye</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
    <tr><td><code>arch: armel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhl</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipsel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Debian Sid (unstable)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: debian/unstable</code> <strong>or</strong>
        <code>image: debian/sid</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr class="table-success">
      <td><code>arch: arm64</code> (experimental)</td>
      <td style="text-align: center;">✓</td>
      <td style="text-align: center;">✗</td>
      <td>manually</td>
    </tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
    <tr><td><code>arch: armel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhl</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipsel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Debian Stretch (oldstable)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: debian/oldstable</code> <strong>or</strong>
        <code>image: debian/stretch</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>manually</td>
    </tr>
    <tr><td><code>arch: armel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhl</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipsel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

**packages**

The packages array is installed with `apt-get install`.

**repositories**

To add custom repositories, specify `url distro component key-id` (separated by
spaces), where `url` is the URL of the package repository, `distro` is e.g.
`jessie` or `stretch`, `component` is e.g. `main` or `non-free`, and `key-id` is
an optional PGP key ID to add to `apt-key`. Example:

```yaml
repositories:
  sr.ht: https://mirror.sr.ht/debian/sr.ht/ stretch main DEADBEEFCAFEF00D
```

## Fedora

Maintainer: Timothée Floure <timothee.floure@posteo.net>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Fedora Rawhide</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: fedora/rawhide</code> <strong>or</strong>
        <code>image: fedora/35</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhfp</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Fedora 34</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: fedora/latest</code> <strong>or</strong>
        <code>image: fedora/34</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhfp</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Fedora 33</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: fedora/33</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhfp</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
  </tbody>
</table>

**packages**

The packages array is installed with `dnf install`.

**repositories**

Given the following list of repositories in your manifest:

```yaml
repositories:
  example: https://example.org
```

The following commands will be used to configure it:

    dnf config-manager --add-repo https://example.org
    dnf config-manager --set-enabled example

## FreeBSD

Maintainer: Simon Ser <contact@emersion.fr>

Support policy: [Upstream production
releases](https://www.freebsd.org/releases/) are supported.

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>FreeBSD 13.x</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: freebsd/latest</code> <strong>or</strong>
        <code>image: freebsd/13.x</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: powerpc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: powerpc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>FreeBSD 12.x</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: freebsd/12.x</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: powerpc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: powerpc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>FreeBSD 11.x</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: freebsd/11.x</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: powerpc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: powerpc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

**packages**

The packages array is installed with `pkg install`.

A snapshot of the ports collection is available at `/usr/ports`. Git can be
used to update it to the latest commit.

**repositories**

Custom package repositories are not supported on FreeBSD builds.

## NetBSD

Maintainer: Michael Forney <mforney@mforney.org>

Support policy: the most recent release and the version prior are supported. See
also: [upstream release cycle](https://wiki.netbsd.org/releng/)

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>NetBSD 9.2</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: netbsd/latest</code> <strong>or</strong>
        <code>image: netbsd/9.x</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>as required</td>
    </tr>
    <tr><td><code>arch: armv6hf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7hf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7hfeb</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipseb</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipsel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64eb</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>NetBSD 8.2</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: netbsd/8.x</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>as required</td>
    </tr>
    <tr><td><code>arch: armv6hf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7hf</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7hfeb</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipseb</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mipsel</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64eb</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: mips64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

**packages**

The packages array is installed with `pkgin`.

**repositories**

Custom package repositories are not supported on NetBSD builds.

## NixOS

Maintainer: Francesco Gazzetta <fgaz@fgaz.me>

Support policy: NixOS upstream does not have a clear support policy. We ship the
latest stable version and the latest bleeding edge.

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>NixOS 21.05</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: nixos/latest</code> <strong>or</strong>
        <code>image: nixos/21.05</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv6</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>NixOS unstable</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: nixos/unstable</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv6</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
  </tbody>
</table>

**packages**

The packages array is installed with `nix-env -iA`. Since it's possible to
specify multiple channels, you must provide the full selection path, for example
`nixos.hello`.

**repositories**

To add custom channels, use `channel-name: channel-url`. The channel name is relevant,
since `channel-name: channel-url` will execute the commands `nix-channel --add
channel-url channel-name` and `nix-channel --update channel-name`.

Example:

```yaml
repositories:
  nixpkgs: https://nixos.org/channels/nixpkgs-unstable
```

By default, no user channels are present.
However, like in a fresh NixOS installation, there is a root channel named
`nixos` set to

* `https://nixos.org/channels/nixos-XX.YY` in `nixos/latest` and `nixos/XX.YY`
* `https://nixos.org/channels/nixos-unstable` in `nixos/unstable`

which is the channel the image was built from.

## OpenBSD

Maintainer: Jarkko Oranen <oranenj@iki.fi>

Support policy: the most recent release and the version prior are supported. See
also: [upstream release cycle](https://www.openbsd.org/faq/faq5.html)

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>OpenBSD 6.9</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: openbsd/latest</code> <strong>or</strong>
        <code>image: openbsd/6.9</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: alpha</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>as required</td>
    </tr>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: hppa</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: landisk</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: loongson</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: luna88k</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: macppc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: octeon</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: power64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>OpenBSD 6.8</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: openbsd/6.8</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: alpha</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>as required</td>
    </tr>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armv7</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: hppa</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: landisk</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: loongson</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: luna88k</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: macppc</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: octeon</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sgi</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: sparc64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

**notes**

Binary patches are applied to the base system using `syspatch`.

**packages**

The packages array is installed with `pkg_add`.

**repositories**

Custom package repositories are not supported on OpenBSD builds.

## Rocky Linux

Maintainer: Haowen Liu <liu.haowen.andy@gmail.com>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Rocky Linux 8</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: rockylinux/latest</code> <strong>or</strong>
        <code>image: rockylinux/8</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: aarch64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: armhfp</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: x86_64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
  </tbody>
</table>

**packages**

The packages array is installed with `dnf install`.

**repositories**

Given the following list of repositories in your manifest:

```yaml
repositories:
  example: https://example.org
```

The following commands will be used to configure it:

    dnf config-manager --add-repo https://example.org
    dnf config-manager --set-enabled example

## Ubuntu

Maintainer: Haowen Liu <liu.haowen.andy@gmail.com>

Support cycle: the latest LTS, previous LTS, and the next normal release of
Ubuntu are all supported. See the [upstream support schedule](https://wiki.ubuntu.com/Releases)
for more information.

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Ubuntu Focal (20.04)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: ubuntu/lts</code> <strong>or</strong>
        <code>image: ubuntu/focal</code> <strong>or</strong>
        <code>image: ubuntu/20.04</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>weekly</td>
    </tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Ubuntu Impish (21.10)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: ubuntu/next</code> <strong>or</strong>
        <code>image: ubuntu/impish</code> <strong>or</strong>
        <code>image: ubuntu/21.10</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>daily</td>
    </tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>Ubuntu Bionic (18.04)</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: ubuntu/oldlts</code> <strong>or</strong>
        <code>image: ubuntu/bionic</code> <strong>or</strong>
        <code>image: ubuntu/18.04</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr><td><code>arch: arm64</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr class="table-primary">
      <td><code>arch: amd64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>monthly</td>
    </tr>
    <tr><td><code>arch: i386</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: ppc64el</code></td><td style="text-align: center"></td><td></td><td></td></tr>
    <tr><td><code>arch: s390x</code></td><td style="text-align: center"></td><td></td><td></td></tr>
  </tbody>
</table>

**packages**

The packages array is installed with `apt-get install`.

**repositories**

To add custom repositories, specify `url distro component key-id` (separated by
spaces), where `url` is the URL of the package repository, `distro` is e.g.
`bionic` or `cosmic`, `component` is e.g. `main` or `non-free`, and `key-id` is
an optional PGP key ID to add to `apt-key`. Example:

```yaml
repositories:
  sr.ht: https://mirror.sr.ht/debian/sr.ht/ cosmic main DEADBEEFCAFEF00D
```

## 9front

Maintainer: Drew DeVault <sir@cmpwn.com>

Support cycle: no support guarantees are made for 9front

<table class="table table-sm table-hover">
  <thead>
    <tr>
      <th>9front "NO THINKPAD"</th>
      <th colspan="3" style="font-weight: normal; text-align: center">
        <code>image: 9front</code>
      </th>
    </tr>
    <tr>
      <th>arch</th>
      <th style="text-align: center">supported</th>
      <th style="text-align: center">native</th>
      <th>updated</th>
    </tr>
  </thead>
  <tbody>
    <tr class="table-primary">
      <td><code>arch: pc64</code> (default)</td>
      <td style="text-align: center; color: green">✓</td>
      <td style="text-align: center; color: green">✓</td>
      <td>manually</td>
    </tr>
  </tbody>
</table>

**Caveats**

- Git submodules are not supported by git9
- 9front ships a dated Mercurial version which is not compatible with hg.sr.ht's
  wire protocol
- Custom packages and custom repositories are not supported
- Shell access is not supported