1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Flatpak Command Reference</title><link rel="stylesheet" type="text/css" href="docbook.css" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /></head><body><div class="reference"><div class="titlepage"><div><div><h1 class="title"><a id="idm140021667440656"></a>Flatpak Command Reference</h1></div><div><p class="releaseinfo">Version 0.11.3</p></div></div><hr /></div><div class="partintro"><div></div><p>
Flatpak comes with a rich commandline interface.
</p><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="#idm140021667438432">Executables</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#flatpak">flatpak</a></span><span class="refpurpose"> — Build, install and run applications and runtimes</span></dt></dl></dd><dt><span class="chapter"><a href="#idm140021665365120">Commands</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#flatpak-build-bundle">flatpak build-bundle</a></span><span class="refpurpose"> — Create a single-file bundle from a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-commit-from">flatpak build-commit-from</a></span><span class="refpurpose"> — Create new commits based on existing one (possibly from another repository)</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-export">flatpak build-export</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-finish">flatpak build-finish</a></span><span class="refpurpose"> — Finalize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-import-bundle">flatpak build-import-bundle</a></span><span class="refpurpose"> — Import a file bundle into a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-init">flatpak build-init</a></span><span class="refpurpose"> — Initialize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-sign">flatpak build-sign</a></span><span class="refpurpose"> — Sign an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-update-repo">flatpak build-update-repo</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build">flatpak build</a></span><span class="refpurpose"> — Build in a directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-config">flatpak config</a></span><span class="refpurpose"> — Manage configuration</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-export">flatpak document-export</a></span><span class="refpurpose"> — Export a file to a sandboxed application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-info">flatpak document-info</a></span><span class="refpurpose"> — Show information about exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-list">flatpak document-list</a></span><span class="refpurpose"> — List exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-unexport">flatpak document-unexport</a></span><span class="refpurpose"> — Stop exporting a file</span></dt><dt><span class="refentrytitle"><a href="#flatpak-enter">flatpak enter</a></span><span class="refpurpose"> — Enter an application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-info">flatpak info</a></span><span class="refpurpose"> — Show information about installed application and/or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-install">flatpak install</a></span><span class="refpurpose"> — Install an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-list">flatpak list</a></span><span class="refpurpose"> — List installed applications and/or runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-make-current">flatpak make-current</a></span><span class="refpurpose"> — Make a specific version of an app current</span></dt><dt><span class="refentrytitle"><a href="#flatpak-override">flatpak override</a></span><span class="refpurpose"> — Override application requirements</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-add">flatpak remote-add</a></span><span class="refpurpose"> — Add a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-delete">flatpak remote-delete</a></span><span class="refpurpose"> — Delete a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-info">flatpak remote-info</a></span><span class="refpurpose"> — Show information about an application or runtime in a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-ls">flatpak remote-ls</a></span><span class="refpurpose"> — Show available runtimes and applications</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-modify">flatpak remote-modify</a></span><span class="refpurpose"> — Modify a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remotes">flatpak remotes</a></span><span class="refpurpose"> — List remote repositories</span></dt><dt><span class="refentrytitle"><a href="#flatpak-repo">flatpak repo</a></span><span class="refpurpose"> — Show information about a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-run">flatpak run</a></span><span class="refpurpose"> — Run an application or open a shell in a runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-search">flatpak search</a></span><span class="refpurpose"> — Search for applications and runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-uninstall">flatpak uninstall</a></span><span class="refpurpose"> — Uninstall an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-update">flatpak update</a></span><span class="refpurpose"> — Update an application or runtime</span></dt></dl></dd><dt><span class="chapter"><a href="#idm140021667501760">File Formats</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="#flatpak-flatpakrepo">flatpakrepo</a></span><span class="refpurpose"> — Reference to a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-flatpakref">flatpakref</a></span><span class="refpurpose"> — Reference to a remote for an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-installation">flatpak installation</a></span><span class="refpurpose"> — Configuration for an installation location</span></dt><dt><span class="refentrytitle"><a href="#flatpak-metadata">flatpak metadata</a></span><span class="refpurpose"> — Information about an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote">flatpak remote</a></span><span class="refpurpose"> — Configuration for a remote</span></dt></dl></dd></dl></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="idm140021667438432"></a>Executables</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak">flatpak</a></span><span class="refpurpose"> — Build, install and run applications and runtimes</span></dt></dl></div><div class="refentry"><a id="flatpak"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak — Build, install and run applications and runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak</code> [OPTION...] {COMMAND}</p></div></div><div class="refsect1"><a id="idm140021660049328"></a><h2>Description</h2><p>
flatpak is a tool for managing applications and the runtimes
they use. In the flatpak model, applications can be built and
distributed independently from the host system they are used
on, and they are isolated from the host system ('sandboxed')
to some degree, at runtime.
</p><p>
flatpak can operate in system-wide or per-user mode. The system-wide
data (runtimes, applications and configuration) is located in
<code class="filename">$prefix/var/lib/flatpak/</code>, and the per-user
data is in <code class="filename">$HOME/.local/share/flatpak/</code>.
Below these locations, there is a local repository in the
<code class="filename">repo/</code> subdirectory and installed runtimes
and applications are in the corresponding <code class="filename">runtime/</code>
and <code class="filename">app/</code> subdirectories.
</p><p>
System-wide remotes can be statically preconfigured by dropping
config fragments into <code class="filename">/etc/flatpak/remotes.d/</code>.
</p><p>
In addition to the system-wide installation in <code class="filename">$prefix/var/lib/flatpak/</code>,
which is always considered the default one unless overridden, more
system-wide installations can be defined via configuration files in
<code class="filename">/etc/flatpak/installations.d/</code>, which must define
at least the id of the installation and the absolute path to it.
Other optional parameters like DisplayName ,
Priority or StorageType
are also supported.
</p><p>
flatpak uses OSTree to distribute and deploy data. The repositories
it uses are OSTree repositories and can be manipulated with the
<span class="command"><strong>ostree</strong></span> utility. Installed runtimes and
applications are OSTree checkouts.
</p></div><div class="refsect1"><a id="idm140021660036096"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing. Use -vv for more detail.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd><dt><span class="term"><code class="option">--default-arch</code></span></dt><dd><p>
Print the default arch and exit.
</p></dd><dt><span class="term"><code class="option">--supported-arches</code></span></dt><dd><p>
Print the supported arches in priority order and exit.
</p></dd><dt><span class="term"><code class="option">--gl-drivers</code></span></dt><dd><p>
Print the list of active gl drivers and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021660021808"></a><h2>Commands</h2><p>Commands for managing installed applications and runtimes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a></span></dt><dd><p>
Install an application or a runtime from a remote or bundle.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a></span></dt><dd><p>
Update an installed application or runtime.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-uninstall"><span class="citerefentry"><span class="refentrytitle">flatpak-uninstall</span>(1)</span></a></span></dt><dd><p>
Uninstall an installed application or runtime.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a></span></dt><dd><p>
List installed applications and/or runtimes.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-info"><span class="citerefentry"><span class="refentrytitle">flatpak-info</span>(1)</span></a></span></dt><dd><p>
Show information for an installed application or runtime.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-config"><span class="citerefentry"><span class="refentrytitle">flatpak-config</span>(1)</span></a></span></dt><dd><p>
Manage flatpak configuration.
</p></dd></dl></div><p>Commands for finding applications and runtimes:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-search"><span class="citerefentry"><span class="refentrytitle">flatpak-search</span>(1)</span></a></span></dt><dd><p>
Search for applications and runtimes.
</p></dd></dl></div><p>Commands for running applications:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a></span></dt><dd><p>
Run an application.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-override"><span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span></a></span></dt><dd><p>
Override permissions for an application.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-make-current"><span class="citerefentry"><span class="refentrytitle">flatpak-make-current</span>(1)</span></a></span></dt><dd><p>
Specify the default version to run.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-enter"><span class="citerefentry"><span class="refentrytitle">flatpak-enter</span>(1)</span></a></span></dt><dd><p>
Enter the namespace of a running application.
</p></dd></dl></div><p>Commands for managing file access:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a></span></dt><dd><p>
Grant an application access to a specific file.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a></span></dt><dd><p>
Revoke access to a specific file.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a></span></dt><dd><p>
Show information about a specific file.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a></span></dt><dd><p>
List exported files.
</p></dd></dl></div><p>Commands for managing remote repositories:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a></span></dt><dd><p>
List all configured remote repositories.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a></span></dt><dd><p>
Add a new remote repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a></span></dt><dd><p>
Modify properties of a configured remote repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a></span></dt><dd><p>
Delete a configured remote repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-ls"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-ls</span>(1)</span></a></span></dt><dd><p>
List contents of a configured remote repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-remote-info"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-info</span>(1)</span></a></span></dt><dd><p>
Show information about a ref in a configured remote repository.
</p></dd></dl></div><p>Commands for building applications:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a></span></dt><dd><p>
Initialize a build directory.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a></span></dt><dd><p>
Run a build command in a build directory.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a></span></dt><dd><p>
Finalizes a build directory for export.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a></span></dt><dd><p>
Export a build directory to a repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span></a></span></dt><dd><p>
Create a bundle file from a ref in a local repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-import-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-import-bundle</span>(1)</span></a></span></dt><dd><p>
Import a file bundle into a local repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-sign"><span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span></a></span></dt><dd><p>
Sign an application or runtime after its been exported.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a></span></dt><dd><p>
Update the summary file in a repository.
</p></dd><dt><span class="term"><a class="citerefentry" href="#flatpak-build-commit-from"><span class="citerefentry"><span class="refentrytitle">flatpak-build-commit-from</span>(1)</span></a></span></dt><dd><p>
Create a new commit based on an existing ref.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021659953600"></a><h2>Environment</h2><p>
Besides standard environment variables such as <code class="envar">XDG_DATA_DIRS</code> and
<code class="envar">XDG_DATA_HOME</code>, flatpak is consulting some of its own.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="envar">FLATPAK_USER_DIR</code></span></dt><dd><p>
The location of the per-user installation. If this is not set,
<code class="filename">$XDG_DATA_HOME/flatpak</code> is used.
</p></dd><dt><span class="term"><code class="envar">FLATPAK_SYSTEM_DIR</code></span></dt><dd><p>
The location of the default system-wide installation. If this is not set,
<code class="filename">/var/lib/flatpak</code> is used (unless overridden at build
time by --localstatedir or --with-system-install-dir).
</p></dd><dt><span class="term"><code class="envar">FLATPAK_CONFIG_DIR</code></span></dt><dd><p>
The location of flatpak site configuration. If this is not set,
<code class="filename">/etc/flatpak</code> is used (unless overridden at build
time by --sysconfdir).
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021659943520"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#ostree.repo"><span class="citerefentry"><span class="refentrytitle">ostree.repo</span>(5)</span></a>,
<a class="citerefentry" href="#flatpak-remote"><span class="citerefentry"><span class="refentrytitle">flatpak-remote</span>(5)</span></a>,
</p></div></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="idm140021665365120"></a>Commands</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak-build-bundle">flatpak build-bundle</a></span><span class="refpurpose"> — Create a single-file bundle from a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-commit-from">flatpak build-commit-from</a></span><span class="refpurpose"> — Create new commits based on existing one (possibly from another repository)</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-export">flatpak build-export</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-finish">flatpak build-finish</a></span><span class="refpurpose"> — Finalize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-import-bundle">flatpak build-import-bundle</a></span><span class="refpurpose"> — Import a file bundle into a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-init">flatpak build-init</a></span><span class="refpurpose"> — Initialize a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-sign">flatpak build-sign</a></span><span class="refpurpose"> — Sign an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build-update-repo">flatpak build-update-repo</a></span><span class="refpurpose"> — Create a repository from a build directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-build">flatpak build</a></span><span class="refpurpose"> — Build in a directory</span></dt><dt><span class="refentrytitle"><a href="#flatpak-config">flatpak config</a></span><span class="refpurpose"> — Manage configuration</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-export">flatpak document-export</a></span><span class="refpurpose"> — Export a file to a sandboxed application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-info">flatpak document-info</a></span><span class="refpurpose"> — Show information about exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-list">flatpak document-list</a></span><span class="refpurpose"> — List exported files</span></dt><dt><span class="refentrytitle"><a href="#flatpak-document-unexport">flatpak document-unexport</a></span><span class="refpurpose"> — Stop exporting a file</span></dt><dt><span class="refentrytitle"><a href="#flatpak-enter">flatpak enter</a></span><span class="refpurpose"> — Enter an application</span></dt><dt><span class="refentrytitle"><a href="#flatpak-info">flatpak info</a></span><span class="refpurpose"> — Show information about installed application and/or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-install">flatpak install</a></span><span class="refpurpose"> — Install an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-list">flatpak list</a></span><span class="refpurpose"> — List installed applications and/or runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-make-current">flatpak make-current</a></span><span class="refpurpose"> — Make a specific version of an app current</span></dt><dt><span class="refentrytitle"><a href="#flatpak-override">flatpak override</a></span><span class="refpurpose"> — Override application requirements</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-add">flatpak remote-add</a></span><span class="refpurpose"> — Add a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-delete">flatpak remote-delete</a></span><span class="refpurpose"> — Delete a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-info">flatpak remote-info</a></span><span class="refpurpose"> — Show information about an application or runtime in a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-ls">flatpak remote-ls</a></span><span class="refpurpose"> — Show available runtimes and applications</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote-modify">flatpak remote-modify</a></span><span class="refpurpose"> — Modify a remote repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remotes">flatpak remotes</a></span><span class="refpurpose"> — List remote repositories</span></dt><dt><span class="refentrytitle"><a href="#flatpak-repo">flatpak repo</a></span><span class="refpurpose"> — Show information about a local repository</span></dt><dt><span class="refentrytitle"><a href="#flatpak-run">flatpak run</a></span><span class="refpurpose"> — Run an application or open a shell in a runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-search">flatpak search</a></span><span class="refpurpose"> — Search for applications and runtimes</span></dt><dt><span class="refentrytitle"><a href="#flatpak-uninstall">flatpak uninstall</a></span><span class="refpurpose"> — Uninstall an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-update">flatpak update</a></span><span class="refpurpose"> — Update an application or runtime</span></dt></dl></div><div class="refentry"><a id="flatpak-build-bundle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-bundle — Create a single-file bundle from a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-bundle</code> [OPTION...] LOCATION FILENAME NAME [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021660229504"></a><h2>Description</h2><p>
Creates a single-file named FILENAME
for the application (or runtime) named NAME
in the repository at LOCATION . If
a BRANCH is specified, this branch of
the application is used.
</p><p>
The format of the bundle file is that of an ostree static delta
(against an empty base) with some flatpak specific metadata for
the application icons and appdata.
</p></div><div class="refsect1"><a id="idm140021658496992"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Export a runtime instead of an application.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The arch to create a bundle for.
</p></dd><dt><span class="term"><code class="option">--repo-url=URL</code></span></dt><dd><p>
The URL for the repository from which the
application can be updated. Installing the
bundle will automatically configure a remote
for this URL.
</p></dd><dt><span class="term"><code class="option">--runtime-repo=URL</code></span></dt><dd><p>
The URL for a .flatpakrepo file that contains
the information about the repository that supplies
the runtimes required by the app.
</p></dd><dt><span class="term"><code class="option">--gpg-keys=FILE</code></span></dt><dd><p>
Add the GPG key from FILE (use - for stdin).
</p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
GPG Homedir to use when looking for keyrings.
</p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
Export to an OCI image instead of a Flatpak bundle.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021661152768"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-import-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-import-bundle</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-commit-from"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-commit-from — Create new commits based on existing one (possibly from another repository)</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-commit-from</code> [OPTION...] DST-REPO DST-REF... </p></div></div><div class="refsect1"><a id="idm140021661141744"></a><h2>Description</h2><p>
Creates new commits on the DST-REF
branch in the DST-REPO , with the
contents (and most of the metadata) taken from another
branch, either from another repo, or from another branch in
the same repository.
</p><p>
This command is very useful when you want to maintain a branch
with a clean history that has no unsigned or broken commits.
For instance, you can import the head from a different repository
from an automatic builder when you've verified that it worked.
The new commit will have no parents or signatures from the
autobuilder, and can be properly signed with the official
key.
</p><p>
Any deltas that affect the original commit and that match parent
commits in the destination repository are copied and rewritten
for the new commit id.
</p></div><div class="refsect1"><a id="idm140021661137344"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--src-repo=SRC-REPO</code></span></dt><dd><p>
The (local) repository to pull the source branch from. Defaults to the
destination repository.
</p></dd><dt><span class="term"><code class="option">--src-ref=SRC-REF</code></span></dt><dd><p>
The branch to use as the source for the new commit. Defaults to the same
as the destination ref, which is useful only if a different source repo
has been specified.
</p></dd><dt><span class="term"><code class="option">--untrusted</code></span></dt><dd><p>
The source repostory is not trusted, all objects are copied (not hardlinked) and
all checksums are verified.
</p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--subject=SUBJECT</code></span></dt><dd><p>
One line subject for the commit message. If not specified, will be taken from the source commit.
</p></dd><dt><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--body=BODY</code></span></dt><dd><p>
Full description for the commit message. If not specified, will be taken from the source commit.
</p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
Update the appstream branch after the build.
</p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
Don't update the summary file after the new commit is added. This means
the repository will not be useful for serving over http until build-update-repo
has been run. This is useful is you want to do multiple repo operations before
finally updating the summary.
</p></dd><dt><span class="term"><code class="option">--force</code></span></dt><dd><p>
Create new commit even if the content didn't change from the existing branch head.
</p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
Sign the commit with this GPG key.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
GPG Homedir to use when looking for keyrings
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657704768"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator</strong></span>
</p><pre class="programlisting">
Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
Metadata Total: 605
Metadata Written: 5
Content Total: 1174
Content Written: 1
Content Bytes Written: 305
</pre></div><div class="refsect1"><a id="idm140021657701744"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-sign"><span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-export — Create a repository from a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-export</code> [OPTION...] LOCATION DIRECTORY [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021658166880"></a><h2>Description</h2><p>
Creates or updates a repository with an application build.
LOCATION is the location of the
repository. DIRECTORY must be a
finalized build directory. If BRANCH
is not specified, it is assumed to be "master".
</p><p>
If LOCATION exists, it is assumed to
be an OSTree repository, otherwise a new OSTree repository is
created at this location. The repository can be inspected with
the <span class="command"><strong>ostree</strong></span> tool.
</p><p>
The contents of DIRECTORY are committed
on the branch with name <code class="literal">app/APPNAME/ARCH/BRANCH</code>,
where ARCH is the architecture of the runtime that the application
is using. A commit filter is used to enforce that only the contents
of the <code class="filename">files/</code> and <code class="filename">export/</code>
subdirectories and the <code class="filename">metadata</code> file are included
in the commit, anything else is ignored.
</p><p>
The build-update-repo command should be used to update repository
metadata whenever application builds are added to a repository.
</p></div><div class="refsect1"><a id="idm140021657863856"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--subject=SUBJECT</code></span></dt><dd><p>
One line subject for the commit message.
</p></dd><dt><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--body=BODY</code></span></dt><dd><p>
Full description for the commit message.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
Specify the architecture component of the branch to export. Only host compatible architectures can be specified.
</p></dd><dt><span class="term"><code class="option">--exclude=PATTERN</code></span></dt><dd><p>
Exclude files matching PATTERN from the commit.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--include=PATTERN</code></span></dt><dd><p>
Don't exclude files matching PATTERN from the commit, even if they match the --export patterns.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--metadata=FILENAME</code></span></dt><dd><p>
Use the specified filename as metadata in the exported app instead of
the default file (called <code class="filename">metadata</code>). This is useful
if you want to commit multiple things from a single build tree, typically
used in combination with --files and --exclude.
</p></dd><dt><span class="term"><code class="option">--files=SUBDIR</code></span></dt><dd><p>
Use the files in the specified subdirectory as the file contents, rather
than the regular <code class="filename">files</code> directory.
</p></dd><dt><span class="term"><code class="option">--timestamp=DATE</code></span></dt><dd><p>
Use the specified ISO 8601 formatted date in the commit metadata and, if <code class="option">--update-appstream</code> is used, the appstream data.
</p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
Update the appstream branch after the build.
</p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
Don't update the summary file after the new commit is added. This means
the repository will not be useful for serving over http until build-update-repo
has been run. This is useful is you want to do multiple repo operations before
finally updating the summary.
</p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
Sign the commit with this GPG key.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
GPG Homedir to use when looking for keyrings
</p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Export a runtime instead for an app (this uses the usr subdir as files).
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021662098896"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak build-export ~/repos/gnome-calculator/ ~/build/gnome-calculator/ org.gnome.Calculator</strong></span>
</p><pre class="programlisting">
Commit: 9d0044ea480297114d03aec85c3d7ae3779438f9d2cb69d717fb54237acacb8c
Metadata Total: 605
Metadata Written: 5
Content Total: 1174
Content Written: 1
Content Bytes Written: 305
</pre></div><div class="refsect1"><a id="idm140021662095872"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-sign"><span class="citerefentry"><span class="refentrytitle">flatpak-build-sign</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-finish"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-finish — Finalize a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-finish</code> [OPTION...] DIRECTORY </p></div></div><div class="refsect1"><a id="idm140021657712720"></a><h2>Description</h2><p>
Finalizes a build directory, to prepare it for exporting.
DIRECTORY is the name of the directory.
</p><p>
The result of this command is that desktop files, icons and
D-Bus service files from the <code class="filename">files</code> subdirectory
are copied to a new <code class="filename">export</code> subdirectory. In the
<code class="filename">metadata</code> file, the command key is set in the
[Application] group, and the supported keys in the [Environment]
group are set according to the options.
</p><p>
You should review the exported files and the application metadata
before creating and distributing an application bundle.
</p><p>
It is an error to run build-finish on a directory that has not
been initialized as a build directory, or has already been finalized.
</p></div><div class="refsect1"><a id="idm140021658208352"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--command=COMMAND</code></span></dt><dd><p>
The command to use. If this option is not specified,
the first executable found in <code class="filename">files/bin</code>
is used.
</p></dd><dt><span class="term"><code class="option">--require-version=MAJOR.MINOR.MICRO</code></span></dt><dd><p>
Require this version of later of flatpak to install/update to this build.
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
Share a subsystem with the host session. This updates
the [Context] group in the metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
Don't share a subsystem with the host session. This updates
the [Context] group in the metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
Expose a well known socket to the application. This updates
the [Context] group in the metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
Don't expose a well known socket to the application. This updates
the [Context] group in the metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
Expose a device to the application. This updates
the [Context] group in the metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
Don't expose a device to the application. This updates
the [Context] group in the metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
Allow access to a specific feature. This updates
the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p><p>
The <code class="code">devel</code> feature allows the application to
access certain syscalls such as <code class="code">ptrace()</code>, and
<code class="code">perf_event_open()</code>.
</p><p>
The <code class="code">multiarch</code> feature allows the application to
execute programs compiled for an ABI other than the one supported
natively by the system. For example, for the <code class="code">x86_64</code>
architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
well.
</p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
Disallow access to a specific feature. This updates
the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
This updates the [Context] group in the metadata.
FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
xdg-config, xdg-cache, xdg-data, an absolute path, or a homedir-relative
path like ~/dir or paths relative to the xdg dirs, like xdg-download/subdir.
The optional :ro suffix indicates that the location will be read-only.
The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
Remove access to the specified subset of the filesystem from
the application. This overrides to the Context section from the
application metadata.
FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
</p><pre class="programlisting">
[Policy subsystem]
key=v1;v2;
</pre><p>
</p><p>
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
This updates the [Environment] group in the metadata.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to own all matching names.
This updates the [Session Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to talk to all matching names.
This updates the [Session Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to own all matching names.
This updates the [System Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to talk to all matching names.
This updates the [System Bus Policy] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
If the application doesn't have access to the real homedir, make the (homedir-relative) path
FILENAME a bind mount to the corresponding path in the per-application directory,
allowing that location to be used for persistent data.
This updates the [Context] group in the metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--runtime=RUNTIME</code>, </span><span class="term"><code class="option">--sdk=SDK</code></span></dt><dd><p>
Change the runtime or sdk used by the app to the specified partial ref. Unspecified parts
of the ref are taken from the old values or defaults.
</p></dd><dt><span class="term"><code class="option">--metadata=GROUP=KEY[=VALUE]</code></span></dt><dd><p>
Set a generic key in the metadata file. If value is left out it will
be set to "true".
</p></dd><dt><span class="term"><code class="option">--extension=NAME=VARIABLE[=VALUE]</code></span></dt><dd><p>
Add extension point info.
</p></dd><dt><span class="term"><code class="option">--extension-priority=VALUE</code></span></dt><dd><p>
Set the priority (library override order) of the extension point.
Only useful for extensions. 0 is the default, and higher value means higher
priority.
</p></dd><dt><span class="term"><code class="option">--extra-data=NAME:SHA256:DOWNLOAD-SIZE:INSTALL-SIZE:URL</code></span></dt><dd><p>
Adds information about extra data uris to the app. These will be downloaded
and verified by the client when the app is installed and placed in the
/app/extra directory. You can also supply an /app/bin/apply_extra script
that will be run after the files are downloaded.
</p></dd><dt><span class="term"><code class="option">--no-exports</code></span></dt><dd><p>
Don't look for exports in the build.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021662060240"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak build-finish /build/my-app --socket=x11 --share=ipc</strong></span>
</p><pre class="programlisting">
Exporting share/applications/gnome-calculator.desktop
Exporting share/dbus-1/services/org.gnome.Calculator.SearchProvider.service
More than one executable
Using gcalccmd as command
Please review the exported files and the metadata
</pre></div><div class="refsect1"><a id="idm140021662057264"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-import-bundle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-import-bundle — Import a file bundle into a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-import-bundle</code> [OPTION...] LOCATION FILENAME </p></div></div><div class="refsect1"><a id="idm140021660436832"></a><h2>Description</h2><p>
Imports a bundle from a file named FILENAME
into the repository at LOCATION .
</p><p>
The format of the bundle file is that generated by build-bundle.
</p></div><div class="refsect1"><a id="idm140021659316368"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ref=REF</code></span></dt><dd><p>
Override the ref specified in the bundle.
</p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
Import an OCI image instead of a Flatpak bundle.
</p></dd><dt><span class="term"><code class="option">--update-appstream</code></span></dt><dd><p>
Update the appstream branch after the build.
</p></dd><dt><span class="term"><code class="option">--no-update-summary</code></span></dt><dd><p>
Don't update the summary file after the new commit is added. This means
the repository will not be useful for serving over http until build-update-repo
has been run. This is useful is you want to do multiple repo operations before
finally updating the summary.
</p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
Sign the commit with this GPG key.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
GPG Homedir to use when looking for keyrings
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021661450496"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-update-repo"><span class="citerefentry"><span class="refentrytitle">flatpak-build-update-repo</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-init"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-init — Initialize a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-init</code> [OPTION...] DIRECTORY APPNAME SDK RUNTIME [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021659386272"></a><h2>Description</h2><p>
Initializes a directory for building an application.
DIRECTORY is the name of the directory.
APPNAME is the application id of the app
that will be built.
SDK and RUNTIME
specify the sdk and runtime that the application should be built
against and run in.
</p><p>
The result of this command is that a <code class="filename">metadata</code>
file is created inside the given directory. Additionally, empty
<code class="filename">files</code> and <code class="filename">var</code> subdirectories
are created.
</p><p>
It is an error to run build-init on a directory that has already
been initialized as a build directory.
</p></div><div class="refsect1"><a id="idm140021661655680"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The architecture to use.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--var=RUNTIME</code></span></dt><dd><p>
Initialize var from the named runtime.
</p></dd><dt><span class="term"><code class="option">-w</code>, </span><span class="term"><code class="option">--writable-sdk</code></span></dt><dd><p>
Initialize /usr with a copy of the sdk, which is writable during flatpak build. This can be used
if you need to install build tools in /usr during the build. This is stored in the
<code class="filename">usr</code> subdirectory of the app dir, but will not be part of the final
app.
</p></dd><dt><span class="term"><code class="option">--tag=TAG</code></span></dt><dd><p>
Add a tag to the metadata file.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--sdk-extension=EXTENSION</code></span></dt><dd><p>
When using --writable-sdk, in addition to the sdk, also install the specified extension.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--sdk-dir</code></span></dt><dd><p>
Specify a custom subdirectory to use instead of <code class="filename">usr</code> for --writable-sdk.
</p></dd><dt><span class="term"><code class="option">--update</code></span></dt><dd><p>
Re-initialize the sdk and var, don't fail if already initialized.
</p></dd><dt><span class="term"><code class="option">--base=APP</code></span></dt><dd><p>
Initialize the application with files from another specified application.
</p></dd><dt><span class="term"><code class="option">--base-version=VERSION</code></span></dt><dd><p>
Specify the version to use for --base. If not specified, will default to
"master".
</p></dd><dt><span class="term"><code class="option">--base-extension=EXTENSION</code></span></dt><dd><p>
When using --base, also install the specified extension from the app.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--type=TYPE</code></span></dt><dd><p>
This can be used to build different types of things. The default
is "app" which is a regular app, but "runtime" creates a runtime
based on an existing runtime, and "extension" creates an extension
for an app or runtime.
</p></dd><dt><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021658856304"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak build-init /build/my-app org.gnome.Sdk org.gnome.Platform 3.16</strong></span>
</p></div><div class="refsect1"><a id="idm140021658854176"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-sign"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-sign — Sign an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-sign</code> [OPTION...] LOCATION ID [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021658809232"></a><h2>Description</h2><p>
Signs the commit for a specified application or runtime in
a local repository. LOCATION is
the location of the repository. ID is the name of the application, or
runtime if --runtime is specified. If BRANCH is not specified, it is
assumed to be "master".
</p><p>
Applications can also be signed during build-export, but
it is sometimes useful to add additional signatures later.
</p></div><div class="refsect1"><a id="idm140021658804336"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
Sign the commit with this GPG key.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
GPG Homedir to use when looking for keyrings
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Sign a runtime instead of an app.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The architecture to use.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021659080048"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak build-sign --gpg-sign=D8BA6573DDD2418027736F1BC33B315E53C1E9D6 /some/repo org.my.App</strong></span>
</p></div><div class="refsect1"><a id="idm140021657733632"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build"><span class="citerefentry"><span class="refentrytitle">flatpak-build</span>(1)</span></a>,
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build-update-repo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build-update-repo — Create a repository from a build directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build-update-repo</code> [OPTION...] LOCATION </p></div></div><div class="refsect1"><a id="idm140021658879936"></a><h2>Description</h2><p>
Updates repository metadata for the repository at
LOCATION . This command generates
an OSTree summary file that lists the contents of the repository.
The summary is used by flatpak remote-ls and other commands
to display the contents of remote repositories.
</p><p>
After this command, LOCATION can be
used as the repository location for flatpak remote-add, either by
exporting it over http, or directly with a file: url.
</p></div><div class="refsect1"><a id="idm140021661290384"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--redirect-url=URL</code></span></dt><dd><p>
Redirect this repo to a new URL.
</p></dd><dt><span class="term"><code class="option">--title=TITLE</code></span></dt><dd><p>
A title for the repository, e.g. for display in a UI.
The title is stored in the repository summary.
</p></dd><dt><span class="term"><code class="option">--default-branch=BRANCH</code></span></dt><dd><p>
A default branch for the repository, mainly for use in a UI.
</p></dd><dt><span class="term"><code class="option">--gpg-import=FILE</code></span></dt><dd><p>
Import a new default GPG public key from the
given file.
</p></dd><dt><span class="term"><code class="option">--gpg-sign=KEYID</code></span></dt><dd><p>
Sign the commit with this GPG key.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--gpg-homedir=PATH</code></span></dt><dd><p>
GPG Homedir to use when looking for keyrings
</p></dd><dt><span class="term"><code class="option">--generate-static-deltas</code></span></dt><dd><p>
Generate static deltas for all references. This generates from-empty and
delta static files that allow for faster download.
</p></dd><dt><span class="term"><code class="option">--prune</code></span></dt><dd><p>
Remove unreferenced objects in repo.
</p></dd><dt><span class="term"><code class="option">--prune-depth</code></span></dt><dd><p>
Only keep at most this number of old versions for any particular ref. Default is -1 which means infinite.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021658546672"></a><h2>See also</h2><p>
<a class="citerefentry" href="#ostree"><span class="citerefentry"><span class="refentrytitle">ostree</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-ls"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-ls</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-build"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-build — Build in a directory</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak build</code> [OPTION...] DIRECTORY [COMMAND [ARG...]]</p></div></div><div class="refsect1"><a id="idm140021661668896"></a><h2>Description</h2><p>
Runs a build command in a directory. DIRECTORY
must have been initialized with <span class="command"><strong>flatpak build-init</strong></span>.
</p><p>
The sdk that is specified in the <code class="filename">metadata</code> file
in the directory is mounted at <code class="filename">/usr</code> and the
<code class="filename">files</code> and <code class="filename">var</code> subdirectories
are mounted at <code class="filename">/app</code> and <code class="filename">/var</code>,
respectively. They are writable, and their contents are preserved between
build commands, to allow accumulating build artifacts there.
</p></div><div class="refsect1"><a id="idm140021659594224"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Use the non-devel runtime that is specified in the application metadata instead of the devel runtime.
</p></dd><dt><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--die-with-parent</code></span></dt><dd><p>
Kill the build process and all children when the launching process dies.
</p></dd><dt><span class="term"><code class="option">--bind-mount=DEST=SOURCE</code></span></dt><dd><p>
Add a custom bind mount in the build namespace. Can be specified multiple times.
</p></dd><dt><span class="term"><code class="option">--build-dir=PATH</code></span></dt><dd><p>
Start the build in this directory (default is in the current directory).
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
Share a subsystem with the host session. This overrides
the Context section from the application metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
Don't share a subsystem with the host session. This overrides
the Context section from the application metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
Expose a well-known socket to the application. This overrides to
the Context section from the application metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
Don't expose a well-known socket to the application. This overrides to
the Context section from the application metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
Expose a device to the application. This overrides to
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
Don't expose a device to the application. This overrides to
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
Allow access to a specific feature. This updates
the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p><p>
The <code class="code">devel</code> feature allows the application to
access certain syscalls such as <code class="code">ptrace()</code>, and
<code class="code">perf_event_open()</code>.
</p><p>
The <code class="code">multiarch</code> feature allows the application to
execute programs compiled for an ABI other than the one supported
natively by the system. For example, for the <code class="code">x86_64</code>
architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
well.
</p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
Disallow access to a specific feature. This updates
the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--filesystem=FILESYSTEM[:ro|:create]</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
This overrides to the Context section from the application metadata.
FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
xdg-config, xdg-cache, xdg-data, an absolute path, or a homedir-relative
path like ~/dir or paths relative to the xdg dirs, like xdg-download/subdir.
The optional :ro suffix indicates that the location will be read-only.
The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
Remove access to the specified subset of the filesystem from
the application. This overrides to the Context section from the
application metadata.
FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--with-appdir</code></span></dt><dd><p>
Expose and configure access to the per-app storage directory in $HOME/.var/app. This is
not normally useful when building, but helps when testing built apps.
</p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
</p><pre class="programlisting">
[Policy subsystem]
key=v1;v2;
</pre><p>
</p><p>
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well-known name NAME on the session bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well-known name NAME on the session bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well-known name NAME on the system bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well-known name NAME on the system bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
If the application doesn't have access to the real homedir, make the (homedir-relative) path
FILENAME a bind mount to the corresponding path in the per-application directory,
allowing that location to be used for persistent data.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--sdk-dir=DIR</code></span></dt><dd><p>
Normally if there is a <code class="filename">usr</code> directory in the build dir, this is used
for the runtime files (this can be created by --writable-sdk or --type=runtime arguments
to build-init). If you specify --sdk-dir this directoryname will be used instead.
Use this if you passed --sdk-dir to build-init.
</p></dd><dt><span class="term"><code class="option">--readonly</code></span></dt><dd><p>
Mount the normally writable destination directories read-only. This can
be useful if you want to run something in the sandbox but guarantee that
it doesn't affect the build results. For example tests.
</p></dd><dt><span class="term"><code class="option">--metadata=FILE</code></span></dt><dd><p>
Use the specified filename as metadata in the exported app instead of
the default file (called <code class="filename">metadata</code>). This is useful
if you build multiple things from a single build tree (such as both a
platform and a sdk).
</p></dd><dt><span class="term"><code class="option">--log-session-bus</code></span></dt><dd><p>
Log session bus traffic. This can be useful to see what access you need to allow in
your D-Bus policy.
</p></dd><dt><span class="term"><code class="option">--log-system-bus</code></span></dt><dd><p>
Log system bus traffic. This can be useful to see what access you need to allow in
your D-Bus policy.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657376048"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak build /build/my-app rpmbuild my-app.src.rpm</strong></span>
</p></div><div class="refsect1"><a id="idm140021657374016"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-init"><span class="citerefentry"><span class="refentrytitle">flatpak-build-init</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-finish"><span class="citerefentry"><span class="refentrytitle">flatpak-build-finish</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-export"><span class="citerefentry"><span class="refentrytitle">flatpak-build-export</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-config"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-config — Manage configuration</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak config</code> [OPTION...] KEY VALUE </p></div></div><div class="refsect1"><a id="idm140021658621328"></a><h2>Description</h2><p>
Show and modify current configuration
</p></div><div class="refsect1"><a id="idm140021658620016"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--list</code></span></dt><dd><p>
Print all keys and their values
</p></dd><dt><span class="term"><code class="option">--set</code></span></dt><dd><p>
Set key KEY to VALUE
</p></dd><dt><span class="term"><code class="option">--unset</code></span></dt><dd><p>
Unset key KEY
</p></dd><dt><span class="term"><code class="option">--get</code></span></dt><dd><p>
Print value of KEY.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Configure per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Configure system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Configure the system-wide installation
specified by NAME among those defined in
<code class="filename">/etc/flatpak/installations.d/</code>. Using
--installation=default is equivalent to using
--system .
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021661861776"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak config --set language sv;en;fi</strong></span>
</p></div><div class="refsect1"><a id="idm140021661859744"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-export"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-export — Export a file to a sandboxed application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-export</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm140021657514944"></a><h2>Description</h2><p>
Creates a document id for a local file that can be exposed to
sandboxed applications, allowing them access to files that they
would not otherwise see. The exported files are exposed in a
fuse filesystem at /run/user/$UID/doc/.
</p><p>
This command also lets you modify the per-application
permissions of the documents, granting or revoking access
to the file on a per-application basis.
</p></div><div class="refsect1"><a id="idm140021661713728"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-u</code>, </span><span class="term"><code class="option">--unique</code></span></dt><dd><p> Don't reuse an existing document id
for the file. This makes it safe to later remove the
document when you're finished with it.
</p></dd><dt><span class="term"><code class="option">-t</code>, </span><span class="term"><code class="option">--transient</code></span></dt><dd><p>
The document will only exist for the length of
the session. This is useful for temporary grants.
</p></dd><dt><span class="term"><code class="option">-n</code>, </span><span class="term"><code class="option">--noexist</code></span></dt><dd><p>
Don't require the file to exist already.
</p></dd><dt><span class="term"><code class="option">-a</code>, </span><span class="term"><code class="option">--app=APPID</code></span></dt><dd><p>
Grant read access to the specified application. The
--allow and --forbid options can be used to grant
or remove additional privileges.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--allow-read</code></span></dt><dd><p>
Grant read access to the applications specified with --app.
This defaults to TRUE.
</p></dd><dt><span class="term"><code class="option">--forbid-read</code></span></dt><dd><p>
Revoke read access for the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">-w</code>, </span><span class="term"><code class="option">--allow-write</code></span></dt><dd><p>
Grant write access to the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">--forbid-write</code></span></dt><dd><p>
Revoke write access for the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--allow-delete</code></span></dt><dd><p>
Grant the ability to remove the document from the document portal to the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">--forbid-delete</code></span></dt><dd><p>
Revoke the ability to remove the document from the document portal from the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">-g</code>, </span><span class="term"><code class="option">--allow-grant-permission</code></span></dt><dd><p>
Grant the ability to grant further permissions to the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">--forbid-grant-permission</code></span></dt><dd><p>
Revoke the ability to grant further permissions for the applications specified with --app.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656917552"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak document-export --app=org.gnome.GEdit ~/test.txt</strong></span>
</p><pre class="programlisting">
/run/user/1000/doc/e52f9c6a/test.txt
</pre></div><div class="refsect1"><a id="idm140021656918704"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-info — Show information about exported files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-info</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm140021661851600"></a><h2>Description</h2><p>
Shows information about an exported file, such as the
document id, the fuse path, the original location in the
filesystem, and the per-application permissions.
</p><p>
FILE can either be a file in the fuse filesystem at /run/user/$UID/doc/,
or a file anywhere else.
</p></div><div class="refsect1"><a id="idm140021661849728"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021661731696"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak document-info ~/Sources/gtk/gail-3.0.pc</strong></span>
</p><pre class="programlisting">
id: dd32c34a
path: /run/user/1000/doc/dd32c34a/gail-3.0.pc
origin: /home/mclasen/Sources/gtk/gail-3.0.pc
permissions:
org.gnome.gedit read, write
</pre></div><div class="refsect1"><a id="idm140021662003616"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-list — List exported files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-list</code> [OPTION...] [APPID]</p></div></div><div class="refsect1"><a id="idm140021657626288"></a><h2>Description</h2><p>
Lists exported files, with their document id and the
full path to their origin. If an APPID is specified,
only the files exported to this app are listed.
</p></div><div class="refsect1"><a id="idm140021657624976"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656615440"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-unexport"><span class="citerefentry"><span class="refentrytitle">flatpak-document-unexport</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-document-unexport"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-document-unexport — Stop exporting a file</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak document-export</code> [OPTION...] FILE </p></div></div><div class="refsect1"><a id="idm140021659410032"></a><h2>Description</h2><p>
Removes the document id for the file from the
document portal. This will make the document unavailable
to all sandboxed applications.
</p></div><div class="refsect1"><a id="idm140021659408528"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656845536"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-export"><span class="citerefentry"><span class="refentrytitle">flatpak-document-export</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-info"><span class="citerefentry"><span class="refentrytitle">flatpak-document-info</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-document-list"><span class="citerefentry"><span class="refentrytitle">flatpak-document-list</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-enter"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-enter — Enter an application</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak enter</code> [OPTION...] MONITORPID COMMAND [ARG...]</p></div></div><div class="refsect1"><a id="idm140021661350128"></a><h2>Description</h2><p>
Enter a running sandbox.
SANDBOXEDPID must be the pid of a process running in a flatpak sandbox.
COMMAND is the command to run in the sandbox.
Extra arguments are passed on to the command.
</p><p>
This creates a new process within the running sandbox, with the same environment. This is useful
when you want to debug a problem with a running application.
</p><p>
This command requires extra privileges, so must be run as root or via e.g. sudo.
</p></div><div class="refsect1"><a id="idm140021661345824"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021660744080"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak enter 15345 sh</strong></span>
</p></div><div class="refsect1"><a id="idm140021660742048"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-info — Show information about installed application and/or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak info</code> [OPTION...] NAME [BRANCH]</p></div></div><div class="refsect1"><a id="idm140021661276944"></a><h2>Description</h2><p>
Show info about and installed application and/or runtime.
</p><p>
By default, the output is formatted in a friendly format.
If you specify one of the options --show-ref, --show-commit,
--show-origin, --show-metadata or --show-size, the output is instead formatted
in a machine-readable format.
</p><p>
By default, both per-user and system-wide installations
are queried. Use the --user, --system or --installation
options to change this.
</p></div><div class="refsect1"><a id="idm140021656629264"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Query per-user installations.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Query the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Query a system-wide installation by NAME among
those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
Query for this architecture.
</p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--show-ref</code></span></dt><dd><p>
Show the installed ref.
</p></dd><dt><span class="term"><code class="option">-o</code>, </span><span class="term"><code class="option">--show-origin</code></span></dt><dd><p>
Show the remote the ref is installed from.
</p></dd><dt><span class="term"><code class="option">-c</code>, </span><span class="term"><code class="option">--show-commit</code></span></dt><dd><p>
Show the installed commit id.
</p></dd><dt><span class="term"><code class="option">-s</code>, </span><span class="term"><code class="option">--show-size</code></span></dt><dd><p>
Show the installed size.
</p></dd><dt><span class="term"><code class="option">-m</code>, </span><span class="term"><code class="option">--show-metadata</code></span></dt><dd><p>
Show the metadata.
</p></dd><dt><span class="term"><code class="option">-e</code>, </span><span class="term"><code class="option">--show-extensions</code></span></dt><dd><p>
Show the matching extensions.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021661000864"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak info org.gnome.Builder//master</strong></span>
</p></div><div class="refsect1"><a id="idm140021660998944"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-install"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-install — Install an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p>Install from a configured remote:</p><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] REMOTE-NAME REF... </p></div><p>Install from a .flatpakref file:</p><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] [--from] LOCATION </p></div><p>Install from a .flatpak bundle:</p><div class="cmdsynopsis"><p><code class="command">flatpak install</code> [OPTION...] [--bundle] FILENAME </p></div></div><div class="refsect1"><a id="idm140021657017888"></a><h2>Description</h2><p>
Installs an application or runtime. The primary way to
install is to specify a [REMOTE]
name as the source and one ore more [REF]s to specify the
application or runtime to install.
</p><p>
Each REF argument is a full or partial indentifier in the
flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
except ID are optional and can be left out, including the slashes,
so most of the time you need only specify ID. Any part left out will be matched
against what is in the remote, and if there are multiple matches an error message
will list the alternatives.
</p><p>
By default this looks for both apps and runtimes with the given REF in
the specified REMOTE , but you can limit this by using the --app or
--runtime option, or by supplying the initial element in the REF.
</p><p>
If REMOTE is a uri or a path (absolute or relative starting with ./)
to a local repository, then that repository will be used as the source, and a temporary remote
will be created for the lifetime of the REF .
</p><p>
The alternative form of the command ([--from] or
[--bundle] allows you to
install directly from a source such as a .flatpak
single-file bundle, a .flatpakref app description. The options are optional if the first
argument have the right extension.
</p><p>
Note that flatpak allows one to have multiple branches of an application and runtimes
installed and used at the same time. However, only version of an application one can be current,
meaning its exported files (for instance desktop files and icons) are
visible to the host. The last installed version is made current by
default, but you can manually change with make-current.
</p><p>
Unless overridden with the --user or the --installation option, this command installs
the application or runtime in the default system-wide installation.
</p></div><div class="refsect1"><a id="idm140021656787904"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--bundle</code></span></dt><dd><p>
Assume LOCATION is a .flatpak single-bundle file.
This is optional if the arguments ends with .flatpak.
</p></dd><dt><span class="term"><code class="option">--from</code></span></dt><dd><p>
Assume LOCATION is a .flatpakref file containing the details of the app to be installed.
This is optional if the arguments ends with .flatpakref.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Install the application or runtime in a per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Install the application or runtime in the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Install the application or runtime in a system-wide installation
specified by NAME among those defined in
<code class="filename">/etc/flatpak/installations.d/</code>. Using
--installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The default architecture to install for, if not given explicitly in the REF .
</p></dd><dt><span class="term"><code class="option">--subpath=PATH</code></span></dt><dd><p>
Install only a subpath of the ref. This is mainly used to install a subset of locales.
This can be added multiple times to install multiple subpaths.,
</p></dd><dt><span class="term"><code class="option">--gpg-file=FILE</code></span></dt><dd><p>
Check bundle signatures with GPG key from FILE (- for stdin).
</p></dd><dt><span class="term"><code class="option">--no-deploy</code></span></dt><dd><p>
Download the latest version, but don't deploy it.
</p></dd><dt><span class="term"><code class="option">--no-pull</code></span></dt><dd><p>
Don't download the latest version, deploy whatever is locally available.
</p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
Don't download related extensions, such as the locale data.
</p></dd><dt><span class="term"><code class="option">--no-deps</code></span></dt><dd><p>
Don't verify runtime dependencies when installing.
</p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
Assume that all REF s are apps if not explicitly specified.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Assume that all REF s are runtimes if not explicitly specified.
</p></dd><dt><span class="term"><code class="option">-y</code>, </span><span class="term"><code class="option">--assumeyes</code></span></dt><dd><p>
Automatically answer yes to all questions (or pick the most prioritized answer). This is useful for automation.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657342592"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak install gnome org.gnome.gedit2</strong></span>
</p><p>
<span class="command"><strong>$ flatpak --installation=default install gnome org.gnome.gedit2</strong></span>
</p><p>
<span class="command"><strong>$ flatpak --user install gnome org.gnome.gedit//3.22</strong></span>
</p><p>
<span class="command"><strong>$ flatpak --user install https://sdk.gnome.org/gedit.flatpakref</strong></span>
</p></div><div class="refsect1"><a id="idm140021657337152"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-build-bundle"><span class="citerefentry"><span class="refentrytitle">flatpak-build-bundle</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-flatpakref"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakref</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-list — List installed applications and/or runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak list</code> [OPTION...]</p></div></div><div class="refsect1"><a id="idm140021657876320"></a><h2>Description</h2><p>
Lists the names of the installed applications and/or runtime.
</p><p>
By default, both per-user and system-wide installations
are shown. Use the --user, --installation or --system
options to change this.
</p><p>
By default this lists both installed apps and runtime, but you can
change this by using the --app or --runtime option.
</p></div><div class="refsect1"><a id="idm140021656867920"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
List per-user installations.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
List the default system-wide installations.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
List a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
List installations for this architecture.
</p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
Show origin, sizes and other extra information.
</p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
List applications.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
List runtimes.
</p></dd><dt><span class="term"><code class="option">--all</code>, </span><span class="term"><code class="option">-a</code></span></dt><dd><p>
List all installed runtimes, including locale and debug extensions. These are hidden by default.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657587424"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user list</strong></span>
</p><pre class="programlisting">
org.gnome.Builder
org.freedesktop.glxgears
org.gnome.MyApp
org.gnome.GEdit
</pre></div><div class="refsect1"><a id="idm140021658774752"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-make-current"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-make-current — Make a specific version of an app current</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak make-current</code> [OPTION...] APP BRANCH </p></div></div><div class="refsect1"><a id="idm140021659414192"></a><h2>Description</h2><p>
Makes a particular branch of an application current. Only the current branch
of an app has its exported files (such as desktop files and icons) made visible
to the host.
</p><p>
When a new branch is installed it will automatically be made current, so this
command is often not needed.
</p><p>
Unless overridden with the --user or --installation options, this command
changes the default system-wide installation.
</p></div><div class="refsect1"><a id="idm140021660985648"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Update a per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Update the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Updates a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The architecture to install for.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021659006320"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user make-current org.gnome.GEdit 3.14</strong></span>
</p></div><div class="refsect1"><a id="idm140021657150192"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-override"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-override — Override application requirements</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak override</code> [OPTION...] [APP]</p></div></div><div class="refsect1"><a id="idm140021657567920"></a><h2>Description</h2><p>
Overrides the application specified runtime requirements. This can be used
to grant a sandboxed application more or less resources than it requested.
</p><p>
By default the application gets access to the resources it
requested when it is started. But the user can override it
on a particular instance by specifying extra arguments to
flatpak run, or every time by using flatpak override.
</p><p>
If the application id is not specified then the overrides affect all applications,
but the per-application overrides can override the global overrides.
</p><p>
Unless overridden with the --user or --installation options, this command
changes the default system-wide installation.
</p></div><div class="refsect1"><a id="idm140021657565168"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Update a per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Update the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Updates a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
Share a subsystem with the host session. This overrides
the Context section from the application metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
Don't share a subsystem with the host session. This overrides
the Context section from the application metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
Expose a well-known socket to the application. This overrides to
the Context section from the application metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
Don't expose a well-known socket to the application. This overrides to
the Context section from the application metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
Expose a device to the application. This overrides to
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
Don't expose a device to the application. This overrides to
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
Allow access to a specific feature. This updates
the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p><p>
The <code class="code">devel</code> feature allows the application to
access certain syscalls such as <code class="code">ptrace()</code>, and
<code class="code">perf_event_open()</code>.
</p><p>
The <code class="code">multiarch</code> feature allows the application to
execute programs compiled for an ABI other than the one supported
natively by the system. For example, for the <code class="code">x86_64</code>
architecture, 32-bit <code class="code">x86</code> binaries will be allowed as
well.
</p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
Disallow access to a specific feature. This updates
the [Context] group in the metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
This overrides to the Context section from the application metadata.
FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, xdg-run,
xdg-config, xdg-cache, xdg-data,
an absolute path, or a homedir-relative path like ~/dir or paths
relative to the xdg dirs, like xdg-download/subdir.
The optional :ro suffix indicates that the location will be read-only.
The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
Remove access to the specified subset of the filesystem from
the application. This overrides to the Context section from the
application metadata.
FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
</p><pre class="programlisting">
[Policy subsystem]
key=v1;v2;
</pre><p>
</p><p>
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well-known name NAME on the session bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well-known name NAME on the session bus.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to own all matching names.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to talk to all matching names.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
If the application doesn't have access to the real homedir, make the (homedir-relative) path
FILENAME a bind mount to the corresponding path in the per-application directory,
allowing that location to be used for persistent data.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656254320"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak override --nosocket=wayland org.gnome.GEdit</strong></span>
</p><p>
<span class="command"><strong>$ flatpak override --filesystem=home org.mozilla.Firefox</strong></span>
</p></div><div class="refsect1"><a id="idm140021656251152"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-add"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-add — Add a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p>Add from a .flatpakrepo file:</p><div class="cmdsynopsis"><p><code class="command">flatpak remote-add</code> [OPTION...] [--from] NAME LOCATION </p></div><p>Manually specify repo uri and options:</p><div class="cmdsynopsis"><p><code class="command">flatpak remote-add</code> [OPTION...] NAME LOCATION </p></div></div><div class="refsect1"><a id="idm140021656678352"></a><h2>Description</h2><p>
Adds a remote repository to the flatpak repository
configuration. [NAME] is the name for the new
remote, and [LOCATION] is a url or pathname. The
[LOCATION] is either a flatpak repository, or a
.flatpakrepo file which describes a repository. In the
former case you may also have to specify extra options,
such as the gpg key for the repo.
</p><p>
Unless overridden with the --user or --installation options, this command
changes the default system-wide installation.
</p></div><div class="refsect1"><a id="idm140021656673632"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--from</code></span></dt><dd><p>
Assume the URI is a .flatpakrepo file rather than the repository itself. This is enabled
by default if the extension is .flatpakrepo, so generally you don't need this option.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Modify the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Modify the default system-wide configuration.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Modify a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--no-gpg-verify</code></span></dt><dd><p>
Disable GPG verification for the added remote.
</p></dd><dt><span class="term"><code class="option">--prio=PRIO</code></span></dt><dd><p>
Set the priority for the remote. Default is 1, higher is more prioritized. This is
mainly used for graphical installation tools.
</p></dd><dt><span class="term"><code class="option">--no-enumerate</code></span></dt><dd><p>
Mark the remote as not enumerated. This means the remote will
not be used to list applications, for instance in graphical
installation tools.
</p></dd><dt><span class="term"><code class="option">--no-use-for-deps</code></span></dt><dd><p>
Mark the remote as not to be used for automatic runtime
dependency resolution.
</p></dd><dt><span class="term"><code class="option">--if-not-exists</code></span></dt><dd><p>
Do nothing if the provided remote already exists.
</p></dd><dt><span class="term"><code class="option">--disable</code></span></dt><dd><p>
Disable the added remote.
</p></dd><dt><span class="term"><code class="option">--title=TITLE</code></span></dt><dd><p>
A title for the remote, e.g. for display in a UI.
</p></dd><dt><span class="term"><code class="option">--default-branch=BRANCH</code></span></dt><dd><p>
A default branch for the remote, mainly for use in a UI.
</p></dd><dt><span class="term"><code class="option">--gpg-import=FILE</code></span></dt><dd><p>
Import gpg keys from the specified keyring file as
trusted for the new remote. If the file is - the
keyring is read from standard input.
</p></dd><dt><span class="term"><code class="option">--oci</code></span></dt><dd><p>
This is a OCI format registry rather than a regular
flatpak repository.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657259264"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo</strong></span>
</p><p>
<span class="command"><strong>$ flatpak --user remote-add --no-gpg-verify test-repo https://people.gnome.org/~alexl/gnome-sdk/repo/</strong></span>
</p></div><div class="refsect1"><a id="idm140021656272320"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-flatpakrepo"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakrepo</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-delete"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-delete — Delete a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-delete</code> [OPTION...] NAME </p></div></div><div class="refsect1"><a id="idm140021656260544"></a><h2>Description</h2><p>
Removes a remote repository from the flatpak repository configuration.
NAME is the name of an existing remote.
</p><p>
Unless overridden with the --system, --user, or --installation options,
this command uses either the default system-wide installation or the
per-user one, depending on which has the specified
REMOTE .
</p></div><div class="refsect1"><a id="idm140021658586656"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Modify the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Modify the default system-wide configuration.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Modify a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--force</code></span></dt><dd><p>
Remove remote even if its in use by installed apps or runtimes.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021661699968"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user remote-delete dried-raisins</strong></span>
</p></div><div class="refsect1"><a id="idm140021661697936"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-info"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-info — Show information about an application or runtime in a remote</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-info</code> [OPTION...] REMOTE REF </p></div></div><div class="refsect1"><a id="idm140021659785040"></a><h2>Description</h2><p>
Shows information about the runtime or application REF from the
remote repository with the name REMOTE .
You can find all configured remote repositories with flatpak remotes.
</p><p>
By default, the output is formatted in a friendly format.
If you specify one of the options --show-ref, --show-commit,
--show-parent, or --show-metadata, the output is instead formatted
in a machine-readable format.
</p><p>
Unless overridden with the --system, --user, or --installation options,
this command uses either the default system-wide installation or the
per-user one, depending on which has the specified
REMOTE .
</p></div><div class="refsect1"><a id="idm140021656459408"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Use the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Use the default system-wide configuration.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Use a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Assume that REF is a runtime if not explicitly specified.
</p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
Assume that REF is an app if not explicitly specified.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The default architecture to look for, if not given explicitly in the REF .
</p></dd><dt><span class="term"><code class="option">--commit=COMMIT</code></span></dt><dd><p>
Show information about the specific commit, rather than the latest version.
</p></dd><dt><span class="term"><code class="option">--log</code></span></dt><dd><p>
Display a log of previous versions.
</p></dd><dt><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--show-ref</code></span></dt><dd><p>
Show the matched ref.
</p></dd><dt><span class="term"><code class="option">-c</code>, </span><span class="term"><code class="option">--show-commit</code></span></dt><dd><p>
Show the commit id.
</p></dd><dt><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--show-parent</code></span></dt><dd><p>
Show the parent commit id.
</p></dd><dt><span class="term"><code class="option">-m</code>, </span><span class="term"><code class="option">--show-metadata</code></span></dt><dd><p>
Show the metadata.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657171776"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user remote-info flathub org.gnome.gedit</strong></span>
</p><pre class="programlisting">
Ref: app/org.gnome.gedit/x86_64/stable
ID: org.gnome.gedit
Arch: x86_64
Branch: stable
Date: 2017-07-31 16:05:22 +0000
Subject: Build org.gnome.gedit at 3ec291fc1ce4d78220527fa79576f4cc1481ebe5
Commit: 3de7e9dde3bb8382aad9dfbbff20eccd9bf2100bc1887a3619ec0372e8066bf7
Parent: -
Download size: 3,4 MB
Installed size: 11,1 MB
Runtime: org.gnome.Platform/x86_64/3.24
</pre></div><div class="refsect1"><a id="idm140021657169056"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
<a class="citerefentry" href="#flatpak-remote-ls"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-ls</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-ls"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-ls — Show available runtimes and applications</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-ls</code> [OPTION...] [REMOTE]</p></div></div><div class="refsect1"><a id="idm140021657479328"></a><h2>Description</h2><p>
Shows runtimes and applications that are available in the
remote repository with the name REMOTE ,
or all remotes if one isn't specified. You can find all configured
remote repositories with <a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>.
</p><p>
Unless overridden with the --system, --user, or --installation options,
this command uses either the default system-wide installation or the
per-user one, depending on which has the specified
REMOTE .
</p></div><div class="refsect1"><a id="idm140021661425136"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Use the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Use the default system-wide configuration.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Use a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
Show arches, branches and commit ids, in addition to the names.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Show only runtimes, omit applications.
</p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
Show only applications, omit runtimes.
</p></dd><dt><span class="term"><code class="option">--all</code>, </span><span class="term"><code class="option">-a</code></span></dt><dd><p> Show everything. By default locale and
debug extensions as well as secondary arches when the primary
arch in available are hidden.
</p></dd><dt><span class="term"><code class="option">--updates</code></span></dt><dd><p>
Show only those which have updates available.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
Show only those matching the specied architecture. By default, only
supported architectures are shown. Use --arch=* to show all archtectures.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656340544"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user remote-ls --app testrepo</strong></span>
</p><pre class="programlisting">
org.gnome.Builder
org.freedesktop.glxgears
</pre></div><div class="refsect1"><a id="idm140021656337936"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote-modify"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote-modify — Modify a remote repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remote-modify</code> [OPTION...] NAME </p></div></div><div class="refsect1"><a id="idm140021656742960"></a><h2>Description</h2><p>
Modifies options for an existing remote repository in the flatpak repository configuration.
NAME is the name for the remote.
</p><p>
Unless overridden with the --system, --user, or --installation options,
this command uses either the default system-wide installation or the
per-user one, depending on which has the specified
REMOTE .
</p></div><div class="refsect1"><a id="idm140021656739008"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Modify the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Modify the default system-wide configuration.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Modify a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--no-gpg-verify</code></span></dt><dd><p>
Disable GPG verification for the added remote.
</p></dd><dt><span class="term"><code class="option">--gpg-verify</code></span></dt><dd><p>
Enable GPG verification for the added remote.
</p></dd><dt><span class="term"><code class="option">--prio=PRIO</code></span></dt><dd><p>
Set the priority for the remote. Default is 1, higher is more prioritized. This is
mainly used for graphical installation tools.
</p></dd><dt><span class="term"><code class="option">--no-enumerate</code></span></dt><dd><p>
Mark the remote as not enumerated. This means the remote will
not be used to list applications, for instance in graphical
installation tools.
</p></dd><dt><span class="term"><code class="option">--no-use-for-deps</code></span></dt><dd><p>
Mark the remote as not to be used for automatic runtime
dependency resolution.
</p></dd><dt><span class="term"><code class="option">--disable</code></span></dt><dd><p>
Disable the remote. Disabled remotes will not be automatically updated from.
</p></dd><dt><span class="term"><code class="option">--enable</code></span></dt><dd><p>
Enable the remote.
</p></dd><dt><span class="term"><code class="option">--enumerate</code></span></dt><dd><p>
Mark the remote as enumerated. This means the remote will
be used to list applications, for instance in graphical
installation tools.
</p></dd><dt><span class="term"><code class="option">--use-for-deps</code></span></dt><dd><p>
Mark the remote as to be used for automatic runtime
dependency resolution.
</p></dd><dt><span class="term"><code class="option">--title=TITLE</code></span></dt><dd><p>
A title for the remote, e.g. for display in a UI.
</p></dd><dt><span class="term"><code class="option">--default-branch=BRANCH</code></span></dt><dd><p>
A default branch to for the remote, mainly for use in a UI.
</p></dd><dt><span class="term"><code class="option">--url=URL</code></span></dt><dd><p>
Set a new URL.
</p></dd><dt><span class="term"><code class="option">--update-metadata</code></span></dt><dd><p>
A default branch to for the remote, mainly for use in a UI.
</p><p>
Update the remote's extra metadata from the OSTree repository's summary
file. Only xa.title and xa.default-branch are supported at the moment.
</p></dd><dt><span class="term"><code class="option">--gpg-import=FILE</code></span></dt><dd><p>
Import gpg keys from the specified keyring file as
trusted for the new remote. If the file is - the
keyring is read from standard input.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656955360"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user remote-modify --no-gpg-verify test-repo</strong></span>
</p></div><div class="refsect1"><a id="idm140021656953328"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remotes"><span class="citerefentry"><span class="refentrytitle">flatpak-remotes</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remotes"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remotes — List remote repositories</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak remotes</code> [OPTION...]</p></div></div><div class="refsect1"><a id="idm140021659797616"></a><h2>Description</h2><p>
Lists the known remote repositories, in priority order.
</p><p>
By default, both per-user and system-wide installations
are shown. Use the --user, --system or --installation
options to change this.
</p></div><div class="refsect1"><a id="idm140021657001488"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Show the per-user configuration.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Show the default system-wide configuration.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Show a system-wide installation by NAME among
those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--show-details</code></span></dt><dd><p>
Show more information for each repository in addition to the name.
</p></dd><dt><span class="term"><code class="option">--show-disabled</code></span></dt><dd><p>
Show disabled repos.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657468032"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak remotes --user --show-details</strong></span>
</p><pre class="programlisting">
testrepo Test Repository http://209.132.179.91/repo/ no-gpg-verify
</pre></div><div class="refsect1"><a id="idm140021657554096"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-delete"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-delete</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-repo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-repo — Show information about a local repository</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak repo</code> [OPTION...] LOCATION </p></div></div><div class="refsect1"><a id="idm140021657560848"></a><h2>Description</h2><p>
Show information about a local repository.
</p></div><div class="refsect1"><a id="idm140021657559536"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--info</code></span></dt><dd><p>
Print general information about a local repository.
</p></dd><dt><span class="term"><code class="option">--branches</code></span></dt><dd><p>
List the branches in a local repository.
</p></dd><dt><span class="term"><code class="option">--metadata=BRANCH</code></span></dt><dd><p>
Print metadata for a branch in the repository.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021662217440"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak repo --info ~/my-repo</strong></span>
</p></div><div class="refsect1"><a id="idm140021662215408"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-info"><span class="citerefentry"><span class="refentrytitle">flatpak-info</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-run"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-run — Run an application or open a shell in a runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak run</code> [OPTION...] REF [ARG...]</p></div></div><div class="refsect1"><a id="idm140021657329344"></a><h2>Description</h2><p>
If REF names an installed application,
flatpak runs the application in a sandboxed environment. Extra
arguments are passed on to the application.
</p><p>
If REF names a runtime, a shell is opened in the
runtime. This is useful for development and testing.
</p><p>
flatpak creates a sandboxed environment for the application to run in
by mounting the right runtime at <code class="filename">/usr</code> and a writable
directory at <code class="filename">/var</code>, whose content is preserved between
application runs. The application itself is mounted at <code class="filename">/app</code>.
</p><p>
The details of the sandboxed environment are controlled by the application
metadata and various options like --share and --socket that are passed to the run
command: Access is allowed if it was requested either in the application
metadata file or with an option and the user hasn't overridden it.
</p><p>
The remaining arguments are passed to the command that gets run in the sandboxed
environment. See the <code class="option">--file-forwarding</code> for handling of file arguments.
</p></div><div class="refsect1"><a id="idm140021657221120"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The architecture to install for.
</p></dd><dt><span class="term"><code class="option">--command=COMMAND</code></span></dt><dd><p>
The command to run instead of the one listed in the application metadata.
</p></dd><dt><span class="term"><code class="option">--branch=BRANCH</code></span></dt><dd><p>
The branch to use.
</p></dd><dt><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--devel</code></span></dt><dd><p>
Use the devel runtime that is specified in the application metadata instead of the regular runtime, and use a seccomp profile that is less likely to break development tools.
</p></dd><dt><span class="term"><code class="option">--runtime=RUNTIME</code></span></dt><dd><p>
Use this runtime instead of the one that is specified in the application metadata.
This is a full tuple, like for example org.freedesktop.Sdk/x86_64/1.2 , but
partial tuples are allowed. Any empty or missing parts are filled in with the corresponding
values specified by the app.
</p></dd><dt><span class="term"><code class="option">--runtime-version=VERSION</code></span></dt><dd><p>
Use this version of the runtime instead of the one that is specified in the application metadata.
This overrides any version specified with the --runtime option.
</p></dd><dt><span class="term"><code class="option">--share=SUBSYSTEM</code></span></dt><dd><p>
Share a subsystem with the host session. This overrides
the Context section from the application metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--unshare=SUBSYSTEM</code></span></dt><dd><p>
Don't share a subsystem with the host session. This overrides
the Context section from the application metadata.
SUBSYSTEM must be one of: network, ipc.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--socket=SOCKET</code></span></dt><dd><p>
Expose a well known socket to the application. This overrides to
the Context section from the application metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nosocket=SOCKET</code></span></dt><dd><p>
Don't expose a well known socket to the application. This overrides to
the Context section from the application metadata.
SOCKET must be one of: x11, wayland, fallback-x11, pulseaudio, system-bus, session-bus.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--device=DEVICE</code></span></dt><dd><p>
Expose a device to the application. This overrides to
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nodevice=DEVICE</code></span></dt><dd><p>
Don't expose a device to the application. This overrides to
the Context section from the application metadata.
DEVICE must be one of: dri, kvm, all.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--allow=FEATURE</code></span></dt><dd><p>
Allow access to a specific feature. This overrides to
the Context section from the application metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--disallow=FEATURE</code></span></dt><dd><p>
Disallow access to a specific feature. This overrides to
the Context section from the application metadata.
FEATURE must be one of: devel, multiarch.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--filesystem=FS</code></span></dt><dd><p>
Allow the application access to a subset of the filesystem.
This overrides to the Context section from the application metadata.
FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download,
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
xdg-run, xdg-config, xdg-cache, xdg-data,
an absolute path, or a homedir-relative path like ~/dir or paths
relative to the xdg dirs, like xdg-download/subdir.
The optional :ro suffix indicates that the location will be read-only.
The optional :create suffix indicates that the location will be read-write and created if it doesn't exist.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--nofilesystem=FILESYSTEM</code></span></dt><dd><p>
Remove access to the specified subset of the filesystem from
the application. This overrides to the Context section from the
application metadata.
FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
an absolute path, or a homedir-relative path like ~/dir.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--add-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Add generic policy option. For example, "--add-policy=subsystem.key=v1 --add-policy=subsystem.key=v2" would map to this metadata:
</p><pre class="programlisting">
[Policy subsystem]
key=v1;v2;
</pre><p>
</p><p>
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--remove-policy=SUBSYSTEM.KEY=VALUE</code></span></dt><dd><p>
Remove generic policy option. This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--env=VAR=VALUE</code></span></dt><dd><p>
Set an environment variable in the application.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to own all matching names.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the session bus.
If NAME ends with .*, it allows the application to talk to all matching names.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-own-name=NAME</code></span></dt><dd><p>
Allow the application to own the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to own all matching names.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--system-talk-name=NAME</code></span></dt><dd><p>
Allow the application to talk to the well known name NAME on the system bus.
If NAME ends with .*, it allows the application to talk to all matching names.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--persist=FILENAME</code></span></dt><dd><p>
If the application doesn't have access to the real homedir, make the (homedir-relative) path
FILENAME a bind mount to the corresponding path in the per-application directory,
allowing that location to be used for persistent data.
This overrides to the Context section from the application metadata.
This option can be used multiple times.
</p></dd><dt><span class="term"><code class="option">--log-session-bus</code></span></dt><dd><p>
Log session bus traffic. This can be useful to see what access you need to allow in
your D-Bus policy.
</p></dd><dt><span class="term"><code class="option">--log-system-bus</code></span></dt><dd><p>
Log system bus traffic. This can be useful to see what access you need to allow in
your D-Bus policy.
</p></dd><dt><span class="term"><code class="option">--file-forwarding</code></span></dt><dd><p>
If this option is specified, the remaining arguments are scanned, and all arguments
that are enclosed between a pair of '@@' arguments are interpreted as file paths,
exported in the document store, and passed to the command in the form of the
resulting document path. Arguments between '@@u' and '@@' are considered uris,
and any file: uris are exported. The exports are non-persistent and with read and write
permissions for the application.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021656220608"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak run org.gnome.GEdit</strong></span>
</p><p>
<span class="command"><strong>$ flatpak run --devel --command=bash org.gnome.Builder</strong></span>
</p><p>
<span class="command"><strong>$ flatpak run --command=bash org.gnome.Sdk</strong></span>
</p></div><div class="refsect1"><a id="idm140021656216256"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-override"><span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-enter"><span class="citerefentry"><span class="refentrytitle">flatpak-enter</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-search"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-search — Search for applications and runtimes</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak search</code> TEXT </p></div></div><div class="refsect1"><a id="idm140021658054304"></a><h2>Description</h2><p>
Searches for applications and runtimes matching
TEXT . Note that this uses appstream data
that can be updated with <a class="citerefentry" href="#flatpak-update"><span class="citerefentry"><span class="refentrytitle">flatpak-update</span>(1)</span></a>.
The appstream data is updated automatically only if it's at least a day old.
</p></div><div class="refsect1"><a id="idm140021658051424"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Only search through remotes in the per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Only search through remotes in the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Show a system-wide installation by NAME among
those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd></dl></div></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-uninstall"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-uninstall — Uninstall an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak uninstall</code> [OPTION...] [REF...]</p></div></div><div class="refsect1"><a id="idm140021656697280"></a><h2>Description</h2><p>
Uninstalls an application or runtime. REF is a reference to the
application or runtime to uninstall.
</p><p>
Each REF arguments is a full or partial indentifier in the
flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
except ID are optional and can be left out, including the slashes,
so most of the time you need only specify ID. Any part left out will be matched
against what is installed, and if there are multiple matches an error message
will list the alternatives.
</p><p>
By default this looks for both installed apps and runtime
with the given NAME , but you can
limit this by using the --app or --runtime option.
</p><p>
Normally, this command removes the ref for this application/runtime from the
local OSTree repository and purges and objects that are no longer
needed to free up disk space. If the same application is later
reinstalled, the objects will be pulled from the remote repository
again. The --keep-ref option can be used to prevent this.
</p><p>
If all branches of the application/runtime are removed, this command
also purges the data directory for the application.
</p><p>
Unless overridden with the --user or the --installation option, this command updates
the default system-wide installation.
</p></div><div class="refsect1"><a id="idm140021658797824"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--keep-ref</code></span></dt><dd><p>
Keep the ref for the application and the objects belonging to it
in the local repository.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Updates a per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Updates the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Updates a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The architecture to uninstall, instead of the architecture of
the host system.
</p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
Only look for an app with the given name.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Only look for a runtime with the given name.
</p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
Don't uninstall related extensions, such as the locale data.
</p></dd><dt><span class="term"><code class="option">--force-remove</code></span></dt><dd><p>
Remove files even if they're in use by a running application.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021657093344"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user uninstall org.gnome.GEdit</strong></span>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-update"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-update — Update an application or runtime</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">flatpak update</code> [OPTION...] [REF...]</p></div><div class="cmdsynopsis"><p><code class="command">flatpak update</code> [OPTION...] --appstream [REMOTE]</p></div></div><div class="refsect1"><a id="idm140021657600656"></a><h2>Description</h2><p>
Updates applications and runtimes. REF is a reference to the
application or runtime to update. If no REF is given, everything
is updated, as well as appstream info for all remotes.
</p><p>
Each REF arguments is a full or partial indentifier in the
flatpak ref format, which looks like "(app|runtime)/ID/ARCH/BRANCH". All elements
except ID are optional and can be left out, including the slashes,
so most of the time you need only specify ID. Any part left out will be matched
against what is installed, and if there are multiple matches an error message
will list the alternatives.
</p><p>
By default this looks for both apps and runtimes with the given REF ,
but you can limit this by using the --app or --runtime option, or by supplying the initial
element in the REF.
</p><p>
Normally, this command updates the application to the tip
of its branch. But it is possible to check out another commit,
with the --commit option.
</p><p>
Note that updating a runtime is different from installing
a different branch, and runtime updates are expected to keep
strict compatibility. If an application update does cause
a problem, it is possible to go back to the previous
version, with the --commit option.
</p><p>
Unless overridden with the --user, --system or --installation option, this command updates
any matching refs in the standard system-wide installation and the per-user one.
</p></div><div class="refsect1"><a id="idm140021656580288"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span></dt><dd><p>
Show help options and exit.
</p></dd><dt><span class="term"><code class="option">--user</code></span></dt><dd><p>
Update a per-user installation.
</p></dd><dt><span class="term"><code class="option">--system</code></span></dt><dd><p>
Update the default system-wide installation.
</p></dd><dt><span class="term"><code class="option">--installation=NAME</code></span></dt><dd><p>
Updates a system-wide installation specified by NAME
among those defined in <code class="filename">/etc/flatpak/installations.d/</code>.
Using --installation=default is equivalent to using
--system .
</p></dd><dt><span class="term"><code class="option">--arch=ARCH</code></span></dt><dd><p>
The architecture to update for.
</p></dd><dt><span class="term"><code class="option">--subpath=PATH</code></span></dt><dd><p>
Install only a subpath of the ref. This is mainly used to install a subset of locales.
This can be added multiple times to install multiple subpaths.
If this is not specified the subpaths specified at install time are reused.
</p></dd><dt><span class="term"><code class="option">--commit=COMMIT</code></span></dt><dd><p>
Update to this commit, instead of the tip of the branch.
</p></dd><dt><span class="term"><code class="option">--no-deploy</code></span></dt><dd><p>
Download the latest version, but don't deploy it.
</p></dd><dt><span class="term"><code class="option">--no-pull</code></span></dt><dd><p>
Don't download the latest version, deploy whatever is locally available.
</p></dd><dt><span class="term"><code class="option">--no-related</code></span></dt><dd><p>
Don't download related extensions, such as the locale data.
</p></dd><dt><span class="term"><code class="option">--no-deps</code></span></dt><dd><p>
Don't update or install runtime dependencies when installing.
</p></dd><dt><span class="term"><code class="option">--app</code></span></dt><dd><p>
Only look for an app with the given name.
</p></dd><dt><span class="term"><code class="option">--appstream</code></span></dt><dd><p>
Update appstream for REMOTE , or all remotes if no remote is specified.
</p></dd><dt><span class="term"><code class="option">--runtime</code></span></dt><dd><p>
Only look for a runtime with the given name.
</p></dd><dt><span class="term"><code class="option">-y</code>, </span><span class="term"><code class="option">--assumeyes</code></span></dt><dd><p>
Automatically answer yes to all questions (or pick the most prioritized answer). This is useful for automation.
</p></dd><dt><span class="term"><code class="option">--force-remove</code></span></dt><dd><p>
Remove old files even if they're in use by a running application.
</p></dd><dt><span class="term"><code class="option">-v</code>, </span><span class="term"><code class="option">--verbose</code></span></dt><dd><p>
Print debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--ostree-verbose</code></span></dt><dd><p>
Print OSTree debug information during command processing.
</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>
Print version information and exit.
</p></dd></dl></div></div><div class="refsect1"><a id="idm140021655890688"></a><h2>Examples</h2><p>
<span class="command"><strong>$ flatpak --user update org.gnome.GEdit</strong></span>
</p></div><div class="refsect1"><a id="idm140021655888656"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-list"><span class="citerefentry"><span class="refentrytitle">flatpak-list</span>(1)</span></a>
</p></div></div></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="idm140021667501760"></a>File Formats</h2></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="refentrytitle"><a href="#flatpak-flatpakrepo">flatpakrepo</a></span><span class="refpurpose"> — Reference to a remote</span></dt><dt><span class="refentrytitle"><a href="#flatpak-flatpakref">flatpakref</a></span><span class="refpurpose"> — Reference to a remote for an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-installation">flatpak installation</a></span><span class="refpurpose"> — Configuration for an installation location</span></dt><dt><span class="refentrytitle"><a href="#flatpak-metadata">flatpak metadata</a></span><span class="refpurpose"> — Information about an application or runtime</span></dt><dt><span class="refentrytitle"><a href="#flatpak-remote">flatpak remote</a></span><span class="refpurpose"> — Configuration for a remote</span></dt></dl></div><div class="refentry"><a id="flatpak-flatpakrepo"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-flatpakrepo — Reference to a remote</p></div><div class="refsect1"><a id="idm140021657833936"></a><h2>Description</h2><p>
Flatpak uses flatpakrepo files to share information about remotes.
The <code class="filename">flatpakrepo</code> file contains enough information
to add the remote. Use the <span class="command"><strong>flatpak remote-add --from</strong></span>
command to do so.
</p><p>
flatpakrepo files may also contain additional information that is useful
when displaying a remote to the user, e.g. in an app store.
</p><p>
The filename extension commonly used for flatpakrepo files is <code class="filename">.flatpakrepo</code>.
</p></div><div class="refsect1"><a id="idm140021660450752"></a><h2>File format</h2><p>
The flatpakrepo file is using the same .ini file format that is used for
systemd unit files or application .desktop files.
</p><div class="refsect2"><a id="idm140021659627648"></a><h3>[Flatpak Repo]</h3><p>
All the information is contained in the [Flatpak Repo] group.
</p><p>
The following keys can be present in this group:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Version</code> (uint64)</span></dt><dd><p>The version of the file format, must be 1 if present.</p></dd><dt><span class="term"><code class="option">Url</code> (string)</span></dt><dd><p>The url for the remote. This key is mandatory.</p></dd><dt><span class="term"><code class="option">GPGKey</code> (string)</span></dt><dd><p>The base64-encoded gpg key for the remote.</p></dd><dt><span class="term"><code class="option">DefaultBranch</code> (string)</span></dt><dd><p>The default branch to use for this remote.</p></dd><dt><span class="term"><code class="option">Title</code> (string)</span></dt><dd><p>The title of the remote. This should be a user-friendly name that can be displayed e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Comment</code> (string)</span></dt><dd><p>A short summary of the remote, for display e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Description</code> (string)</span></dt><dd><p>A longer description of the remote, for display e.g. in an app store..</p></dd><dt><span class="term"><code class="option">Icon</code> (string)</span></dt><dd><p>The url for an icon that can be used to represent the remote.</p></dd><dt><span class="term"><code class="option">Homepage</code> (string)</span></dt><dd><p>The url of a webpage describing the remote.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021661272880"></a><h2>Example</h2><pre class="programlisting">
[Flatpak Repo]
Title=GEdit
Url=http://sdk.gnome.org/repo-apps/
GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
</pre></div><div class="refsect1"><a id="idm140021655448992"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-remote-add"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-add</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-flatpakref"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakref</span>(5)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-flatpakref"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-flatpakref — Reference to a remote for an application or runtime</p></div><div class="refsect1"><a id="idm140021659789984"></a><h2>Description</h2><p>
Flatpak uses flatpakref files to share information about a remote for
a single application. The <code class="filename">flatpakref</code> file contains
enough information to add the remote and install the application.
Use the <span class="command"><strong>flatpak install --from</strong></span> command to do so.
</p><p>
flatpakref files may also contain additional information that is useful
when displaying the application to the user, e.g. in an app store.
</p><p>
The filename extension commonly used for flatpakref files is <code class="filename">.flatpakref</code>.
</p><p>
A flatpakref file can also refer to a remote for a runtime.
</p></div><div class="refsect1"><a id="idm140021655403120"></a><h2>File format</h2><p>
The flatpakref file is using the same .ini file format that is used for
systemd unit files or application .desktop files.
</p><div class="refsect2"><a id="idm140021655401968"></a><h3>[Flatpak Ref]</h3><p>
All the information is contained in the [Flatpak Ref] group.
</p><p>
The following keys can be present in this group:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Version</code> (uint64)</span></dt><dd><p>The version of the file format, must be 1 if present.</p></dd><dt><span class="term"><code class="option">Name</code> (string)</span></dt><dd><p>The fully qualified name of the runtime that is used by the application. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Url</code> (string)</span></dt><dd><p>The url for the remote. This key is mandatory.</p></dd><dt><span class="term"><code class="option">Branch</code> (string)</span></dt><dd><p>The name of the branch from which to install the application or runtime. If this key is not specified, the "master" branch is used.</p></dd><dt><span class="term"><code class="option">Title</code> (string)</span></dt><dd><p>The title of the application or runtime. This should be a user-friendly name that can be displayed e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Comment</code> (string)</span></dt><dd><p>A short summary of the application or runtime, for display e.g. in an app store.</p></dd><dt><span class="term"><code class="option">Description</code> (string)</span></dt><dd><p>A longer description of the application or runtime, for display e.g. in an app store..</p></dd><dt><span class="term"><code class="option">Icon</code> (string)</span></dt><dd><p>The url for an icon that can be used to represent the application or runtime.</p></dd><dt><span class="term"><code class="option">Homepage</code> (string)</span></dt><dd><p>The url of a webpage describing the application or runtime.</p></dd><dt><span class="term"><code class="option">IsRuntime</code> (boolean)</span></dt><dd><p>Whether this file refers to a runtime. If this key is not specified, the file is assumed to refer to an application.</p></dd><dt><span class="term"><code class="option">GPGKey</code> (string)</span></dt><dd><p>The base64-encoded gpg key for the remote.</p></dd><dt><span class="term"><code class="option">RuntimeRepo</code> (string)</span></dt><dd><p>The url for a .flatpakref file for the runtime.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021662012576"></a><h2>Example</h2><pre class="programlisting">
[Flatpak Ref]
Title=GEdit
Name=org.gnome.gedit
Branch=stable
Url=http://sdk.gnome.org/repo-apps/
IsRuntime=False
GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
</pre></div><div class="refsect1"><a id="idm140021662011104"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-install"><span class="citerefentry"><span class="refentrytitle">flatpak-install</span>(1)</span></a>
<a class="citerefentry" href="#flatpak-flatpakrepo"><span class="citerefentry"><span class="refentrytitle">flatpak-flatpakrepo</span>(5)</span></a>,
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-installation"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-installation — Configuration for an installation location</p></div><div class="refsect1"><a id="idm140021655947472"></a><h2>Description</h2><p>
flatpak can operate in system-wide or per-user mode. The system-wide data
is located in <code class="filename">$prefix/var/lib/flatpak/</code>, and the per-user data is in
<code class="filename">$HOME/.local/share/flatpak/</code>.
</p><p>
In addition to the default installation locations, more system-wide installations
can be defined via configuration files <code class="filename">/etc/flatpak/installations.d/</code>,
which must have the .conf extension and follow the format described below.
</p></div><div class="refsect1"><a id="idm140021655413488"></a><h2>File format</h2><p>
The installation config file format is using the same .ini file format that is used
for systemd unit files or application .desktop files.
</p><div class="refsect2"><a id="idm140021655412144"></a><h3>[Installation …]</h3><p>
All the configuration for the the installation location with name NAME is contained
in the [Installation "NAME"] group.
</p><p>
The following keys are recognized:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">Path</code> (string)</span></dt><dd><p>The path for this installation. This key is mandatory.</p></dd><dt><span class="term"><code class="option">DisplayName</code> (string)</span></dt><dd><p>The name to use when showing this installation in the UI.</p></dd><dt><span class="term"><code class="option">Priority</code> (integer)</span></dt><dd><p>A priority for this installation.</p></dd><dt><span class="term"><code class="option">StorageType</code> (string)</span></dt><dd><p>The type of storage used for this installation. Possible values include: network, mmc, sdcard, harddisk.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021656013536"></a><h2>Examples</h2><pre class="programlisting">
[Installation "extra"]
Path=/location/of/sdcard
DisplayName=Extra Installation
StorageType=sdcard
</pre></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-metadata"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-metadata — Information about an application or runtime</p></div><div class="refsect1"><a id="idm140021661165952"></a><h2>Description</h2><p>
Flatpak uses metadata files to describe applications and runtimes.
The <code class="filename">metadata</code> file for a deployed application or
runtime is placed in the toplevel deploy directory. For example, the
metadata for the locally installed application org.gnome.Calculator
is in
<code class="filename">~/.local/share/flatpak/app/org.gnome.Calculator/current/active/metadata</code>.
</p><p>
Most aspects of the metadata configuration can be overridden when
launching applications, either temporarily via options of the flatpak
run command, or permanently with the flatpak override command.
</p><p>
A metadata file describing the effective configuration is available
inside the running sandbox at <code class="filename">/.flatpak-info</code>.
For compatibility with older Flatpak versions,
<code class="filename">/run/user/$UID/flatpak-info</code> is a symbolic
link to the same file.
</p></div><div class="refsect1"><a id="idm140021661719216"></a><h2>File format</h2><p>
The metadata file is using the same .ini file format that is used for
systemd unit files or application .desktop files.
</p><div class="refsect2"><a id="idm140021661718064"></a><h3>[Application] or [Runtime]</h3><p>
Metadata for applications starts with an [Application] group,
metadata for runtimes with a [Runtime] group.
</p><p>
The following keys can be present in these groups:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">name</code> (string)</span></dt><dd><p>The name of the application or runtime. This key is mandatory.</p></dd><dt><span class="term"><code class="option">runtime</code> (string)</span></dt><dd><p>The fully qualified name of the runtime that is used by the application. This key is mandatory for applications.</p></dd><dt><span class="term"><code class="option">sdk</code> (string)</span></dt><dd><p>
The fully qualified name of the sdk that matches the
runtime. Available since 0.1.</p></dd><dt><span class="term"><code class="option">command</code> (string)</span></dt><dd><p>
The command to run. Only relevant for applications.
Available since 0.1.
</p></dd><dt><span class="term"><code class="option">required-flatpak</code> (string)</span></dt><dd><p>
The required version of Flatpak to run this application
or runtime. For applications, this was available since
0.8.0. For runtimes, this was available since 0.9.1,
and backported to 0.8.3 for the 0.8.x branch.
</p></dd><dt><span class="term"><code class="option">tags</code> (string list)</span></dt><dd><p>
Tags to include in AppStream XML.
Available since 0.4.12.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021657301728"></a><h3>[Context]</h3><p>
This group determines various system resources that may be shared
with the application when it is run in a flatpak sandbox.
</p><p>
All keys in this group (and the group itself) are optional.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">shared</code> (list)</span></dt><dd><p>
List of subsystems to share with the host system.
Possible subsystems: network, ipc.
Available since 0.3.
</p></dd><dt><span class="term"><code class="option">sockets</code> (list)</span></dt><dd><p>
List of well-known sockets to make available in the sandbox.
Possible sockets: x11, wayland, fallback-x11, pulseaudio, session-bus, system-bus.
When making a socket available, flatpak also sets
well-known environment variables like DISPLAY or
DBUS_SYSTEM_BUS_ADDRESS to let the application
find sockets that are not in a fixed location.
Available since 0.3.
</p></dd><dt><span class="term"><code class="option">devices</code> (list)</span></dt><dd><p>
List of devices to make available in the sandbox.
Possible values:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">dri</code></span></dt><dd><p>
Graphics direct rendering
(<code class="filename">/dev/dri</code>).
Available since 0.3.
</p></dd><dt><span class="term"><code class="option">kvm</code></span></dt><dd><p>
Virtualization
(<code class="filename">/dev/kvm</code>).
Available since 0.6.12.
</p></dd><dt><span class="term"><code class="option">all</code></span></dt><dd><p>
All device nodes in <code class="filename">/dev</code>.
Available since 0.6.6.
</p></dd></dl></div><p>
</p></dd><dt><span class="term"><code class="option">filesystems</code> (list)</span></dt><dd><p>
List of filesystem subsets to make available to the
application. Possible values:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">home</code></span></dt><dd><p>
The entire home directory.
Available since 0.3.
</p></dd><dt><span class="term"><code class="option">host</code></span></dt><dd><p>
The entire host file system, except for
directories that are handled specially by
Flatpak.
In particular, this shares
<code class="filename">/home</code>,
<code class="filename">/media</code>,
<code class="filename">/opt</code>,
<code class="filename">/run/media</code> and
<code class="filename">/srv</code> if they exist.
</p><p>
<code class="filename">/dev</code> is not shared:
use <code class="option">devices=all;</code> instead.
</p><p>
Parts of <code class="filename">/sys</code> are always
shared. This option does not make additional
files in /sys available.
</p><p>
These other reserved directories are
currently excluded:
<code class="filename">/app</code>,
<code class="filename">/bin</code>,
<code class="filename">/boot</code>,
<code class="filename">/etc</code>,
<code class="filename">/lib</code>,
<code class="filename">/lib32</code>,
<code class="filename">/lib64</code>,
<code class="filename">/proc</code>,
<code class="filename">/root</code>,
<code class="filename">/run</code>,
<code class="filename">/sbin</code>,
<code class="filename">/tmp</code>,
<code class="filename">/usr</code>,
<code class="filename">/var</code>.
</p><p>
Available since 0.3.
</p></dd><dt><span class="term"><code class="option">xdg-desktop</code>,
<code class="option">xdg-documents</code>,
<code class="option">xdg-download</code>,
<code class="option">xdg-music</code>,
<code class="option">xdg-pictures</code>,
<code class="option">xdg-public-share</code>,
<code class="option">xdg-videos</code>,
<code class="option">xdg-templates</code>
</span></dt><dd><p>
<a class="ulink" href="https://www.freedesktop.org/wiki/Software/xdg-user-dirs/" target="_top">freedesktop.org special directories</a>.
Available since 0.3.
</p></dd><dt><span class="term"><code class="option">xdg-desktop/<em class="replaceable"><code>path</code></em></code>,
<code class="option">xdg-documents/<em class="replaceable"><code>path</code></em></code>,
etc.
</span></dt><dd><p>
Subdirectories of freedesktop.org special
directories. Available since 0.4.13.
</p></dd><dt><span class="term">
<code class="option">xdg-cache</code>,
<code class="option">xdg-config</code>,
<code class="option">xdg-data</code>
</span></dt><dd><p>
Directories defined by the
<a class="ulink" href="https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html" target="_top">freedesktop.org Base Directory
Specification</a>.
Available since 0.6.14.
</p></dd><dt><span class="term">
<code class="option">xdg-cache/<em class="replaceable"><code>path</code></em></code>,
<code class="option">xdg-config/<em class="replaceable"><code>path</code></em></code>,
<code class="option">xdg-data/<em class="replaceable"><code>path</code></em></code>
</span></dt><dd><p>
Subdirectories of directories defined by the
freedesktop.org Base Directory Specification.
Available since 0.6.14.
</p></dd><dt><span class="term">
<code class="option">xdg-run/<em class="replaceable"><code>path</code></em></code>
</span></dt><dd><p>
Subdirectories of the
<code class="envar">XDG_RUNTIME_DIR</code> defined by
the
<a class="ulink" href="https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html" target="_top">freedesktop.org Base Directory
Specification</a>. Note that
<code class="option">xdg-run</code> on its own is not
supported. Available since 0.4.13.
</p></dd><dt><span class="term">
<code class="option">/<em class="replaceable"><code>path</code></em></code>
</span></dt><dd><p>
An arbitrary absolute path. Available since 0.3.
</p></dd><dt><span class="term">
<code class="option">~/<em class="replaceable"><code>path</code></em></code>
</span></dt><dd><p>
An arbitrary path relative to the home
directory. Available since 0.3.
</p></dd><dt><span class="term">
One of the above followed by
<code class="option">:ro</code>
</span></dt><dd><p>
Make the given directory available read-only.
</p></dd><dt><span class="term">
One of the above followed by
<code class="option">:rw</code>
</span></dt><dd><p>
Make the given directory available read/write.
This is the default.
</p></dd><dt><span class="term">
One of the above followed by
<code class="option">:create</code>
</span></dt><dd><p>
Make the given directory available read/write,
and create it if it does not already exist.
</p></dd></dl></div><p>
</p></dd><dt><span class="term"><code class="option">persistent</code> (list)</span></dt><dd><p>
List of homedir-relative paths to make available at
the corresponding path in the per-application home directory,
allowing the locations to be used for persistent data when
the application does not have access to the real homedir.
For instance making ".myapp" persistent would make "~/.myapp"
in the sandbox a bind mount to "~/.var/app/org.my.App/.myapp",
thus allowing an unmodified application to save data in
the per-application location. Available since 0.3.
</p></dd><dt><span class="term"><code class="option">features</code> (list)</span></dt><dd><p>
List of features available or unavailable to the
application, currently from the following list:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">devel</code></span></dt><dd><p>
Allow system calls used by development-oriented
tools such as <span class="command"><strong>perf</strong></span>,
<span class="command"><strong>strace</strong></span> and
<span class="command"><strong>gdb</strong></span>.
Available since 0.6.10.
</p></dd><dt><span class="term"><code class="option">multiarch</code></span></dt><dd><p>
Allow running multilib/multiarch binaries, for
example <code class="literal">i386</code> binaries in an
<code class="literal">x86_64</code> environment.
Available since 0.6.12.
</p></dd></dl></div><p>
A feature can be prefixed with <code class="option">!</code> to
indicate the absence of that feature, for example
<code class="option">!devel</code> if development and debugging
are not allowed.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021656110576"></a><h3>[Instance]</h3><p>
This group only appears in <code class="filename">/.flatpak-info</code>
for a running app, and not in the metadata files written by
application authors. It is filled in by Flatpak itself.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">app-path</code> (string)</span></dt><dd><p>
The absolute path on the host system of the app's
app files, as mounted at <code class="filename">/app</code>
inside the container. Available since 0.6.10.
</p></dd><dt><span class="term"><code class="option">branch</code> (string)</span></dt><dd><p>
The branch of the app, for example
<code class="literal">stable</code>. Available since
0.6.10.
</p></dd><dt><span class="term"><code class="option">flatpak-version</code> (string)</span></dt><dd><p>
The version number of the Flatpak version that ran
this app. Available since 0.6.11.
</p></dd><dt><span class="term"><code class="option">runtime-path</code> (string)</span></dt><dd><p>
The absolute path on the host system of the app's
runtime files, as mounted at <code class="filename">/usr</code>
inside the container. Available since 0.6.10.
</p></dd><dt><span class="term"><code class="option">session-bus-proxy</code> (boolean)</span></dt><dd><p>
True if this app cannot access the D-Bus session bus
directly (either it goes via a proxy, or it cannot
access the session bus at all). Available since 0.8.0.
</p></dd><dt><span class="term"><code class="option">system-bus-proxy</code> (boolean)</span></dt><dd><p>
True if this app cannot access the D-Bus system bus
directly (either it goes via a proxy, or it cannot
access the system bus at all). Available since 0.8.0.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021655878384"></a><h3>[Session Bus Policy]</h3><p>
If the <code class="option">sockets</code> key is not allowing full access
to the D-Bus session bus, then flatpak provides filtered access.
</p><p>
The default policy for the session bus only allows the
application to own its own application ID and
subnames. For instance if the app is called
"org.my.App", it can only own "org.my.App" and
"org.my.App.*". Its also only allowed to talk to the
bus itself (org.freedesktop.DBus) and the portal APIs
APIs (bus names of the form org.freedesktop.portal.*).
</p><p>
Additionally the app is always allowed to reply to
messages sent to it, and emit broadcast signals (but
these will not reach other sandboxed apps unless they
are allowed to talk to your app.
</p><p>
If the [Session Bus Policy] group is present, it provides
policy for session bus access.
</p><p>
Each key in this group has the form of a D-Bus bus name or
prefix thereof, for example <code class="option">org.gnome.SessionManager</code>
or <code class="option">org.freedesktop.portal.*</code>
</p><p>
The possible values for entry are, in increasing order or
access:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">none</code></span></dt><dd><p>
The bus name or names in question is invisible to the application.
Available since 0.2.
</p></dd><dt><span class="term"><code class="option">see</code></span></dt><dd><p>
The bus name or names can be enumerated by the application.
Available since 0.2.
</p></dd><dt><span class="term"><code class="option">talk</code></span></dt><dd><p>
The application can send messages/ and receive replies and signals from the bus name or names.
Available since 0.2.
</p></dd><dt><span class="term"><code class="option">own</code></span></dt><dd><p>
The application can own the bus name or names (as well as all the above).
Available since 0.2.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021655865808"></a><h3>[System Bus Policy]</h3><p>
If the <code class="option">sockets</code> key is not allowing full access
to the D-Bus system bus, then flatpak does not make the system
bus available unless the [System Bus Policy] group is present
and provides a policy for filtered access. Available since 0.2.
</p><p>
Entries in this group have the same form as for the [Session Bus Policy] group.
However, the app has no permissions by default.
</p></div><div class="refsect2"><a id="idm140021655863424"></a><h3>[Environment]</h3><p>
The [Environment] group specifies environment variables to set
when running the application. Available since 0.3.
</p><p>
Entries in this group have the form <code class="option">VAR=VALUE</code>
where <code class="option">VAR</code> is the name of an environment variable
to set.
</p></div><div class="refsect2"><a id="idm140021655860560"></a><h3>[Extension NAME]</h3><p>
Runtimes and applications can define extension points, which allow
optional, additional runtimes to be mounted at a specified location
inside the sandbox when they are present on the system. Typical uses
for extension points include translations for applications, or debuginfo
for sdks. The name of the extension point is specified as part of the
group heading.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">directory</code> (string)</span></dt><dd><p>
The relative path at which the extension will be mounted in
the sandbox. If the extension point is for an application, the
path is relative to <code class="filename">/app</code>, otherwise
it is relative to <code class="filename">/usr</code>. This key
is mandatory. Available since 0.1.
</p></dd><dt><span class="term"><code class="option">version</code> (string)</span></dt><dd><p>
The branch to use when looking for the extension. If this is
not specified, it defaults to the branch of the application or
runtime that the extension point is for.
Available since 0.4.1.
</p></dd><dt><span class="term"><code class="option">versions</code> (string)</span></dt><dd><p>
The branches to use when looking for the extension. If this is
not specified, it defaults to the branch of the application or
runtime that the extension point is for. Available since
0.9.1, and backported to the 0.8.x branch in 0.8.4.
</p></dd><dt><span class="term"><code class="option">add-ld-path</code> (string)</span></dt><dd><p>
A path relative to the extension point directory that will be appended
to LD_LIBRARY_PATH. Available since 0.9.1, and
backported to the 0.8.x branch in 0.8.3.
</p></dd><dt><span class="term"><code class="option">merge-dirs</code> (string)</span></dt><dd><p>
A list of relative paths of directories below the extension point directory
that will be merged. Available since 0.9.1, and
backported to the 0.8.x branch in 0.8.3.
</p></dd><dt><span class="term"><code class="option">download-if</code> (string)</span></dt><dd><p>
A condition that must be true for the extension to be auto-downloaded.
The only currently recognized value is active-gl-driver, which is true
if the name of the active GL driver matches the extension point basename.
Available since 0.9.1, and backported to the 0.8.x
branch in 0.8.3.
</p></dd><dt><span class="term"><code class="option">enable-if</code> (string)</span></dt><dd><p>
A condition that must be true for the extension to be enabled.
The only currently recognized value is active-gl-driver, which is true
if the name of the active GL driver matches the extension point basename.
Available since 0.9.1, and backported to the 0.8.x
branch in 0.8.3.
</p></dd><dt><span class="term"><code class="option">subdirectory-suffix</code> (string)</span></dt><dd><p>
A suffix that gets appended to the directory name. This is very
useful when the extension point naming scheme is "reversed". For example,
an extension point for GTK+ themes would be /usr/share/themes/$NAME/gtk-3.0,
which could be achieved using subdirectory-suffix=gtk-3.0.
Available since 0.9.1, and backported to the 0.8.x
branch in 0.8.3.
</p></dd><dt><span class="term"><code class="option">subdirectories</code> (boolean)</span></dt><dd><p>
If this key is set to true, then flatpak will look for
extensions whose name is a prefix of the extension point name, and
mount them at the corresponding name below the subdirectory.
Available since 0.1.
</p></dd><dt><span class="term"><code class="option">no-autodownload</code> (boolean)</span></dt><dd><p>
Whether to automatically download extensions matching this extension
point when updating or installing a 'related' application or runtime.
Available since 0.6.7.
</p></dd><dt><span class="term"><code class="option">locale-subset</code> (boolean)</span></dt><dd><p>
If set, then the extensions are partially downloaded by default,
based on the currently configured locales. This means that the extension
contents should be a set of directories with the language code as name.
Available since 0.9.13 (and 0.6.6 for any extensions called *.Locale)
</p></dd><dt><span class="term"><code class="option">autodelete</code> (boolean)</span></dt><dd><p>
Whether to automatically delete extensions matching this extension
point when deleting a 'related' application or runtime.
Available since 0.6.7.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021655835216"></a><h3>[ExtensionOf]</h3><p>
This optional group may be present if the runtime is an extension.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">ref</code> (string)</span></dt><dd><p>
The ref of the runtime or application that this extension
belongs to. Available since 0.9.1.
</p></dd><dt><span class="term"><code class="option">priority</code> (integer)</span></dt><dd><p>
The priority to give this extension when looking for the
best match. Default is 0. Available since 0.9.1, and
backported to the 0.8.x branch in 0.8.3.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021655829456"></a><h3>[Extra Data]</h3><p>
This optional group may be present if the runtime or application uses
extra data that gets downloaded separately. The data in this group
gets merged into the repository summary, with the xa.extra-data-sources
key.
</p><p>
If multiple extra data sources are present, their uri, size and checksum
keys are grouped together by using the same suffix. If only one extra
data source is present, the suffix can be omitted.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">NoRuntime</code> (boolean)</span></dt><dd><p>
Whether to mount the runtime while running the /app/bin/apply_extra
script. Defaults to true, i.e. not mounting the runtime.
Available since 0.9.1, and backported to the 0.8.x
branch in 0.8.4.
</p></dd><dt><span class="term"><code class="option">uri<em class="replaceable"><code>X</code></em></code> (string)</span></dt><dd><p>
The uri for extra data source
<em class="replaceable"><code>X</code></em>. The only supported uri
schemes are http and https. Available since 0.6.13.
</p></dd><dt><span class="term"><code class="option">size<em class="replaceable"><code>X</code></em></code> (integer)</span></dt><dd><p>
The size for extra data source
<em class="replaceable"><code>X</code></em>. Available since 0.6.13.
</p></dd><dt><span class="term"><code class="option">checksum<em class="replaceable"><code>X</code></em></code> (string)</span></dt><dd><p>
The sha256 sum for extra data source
<em class="replaceable"><code>X</code></em>. Available since 0.6.13.
</p></dd></dl></div></div><div class="refsect2"><a id="idm140021655817552"></a><h3>[Policy SUBSYSTEM]</h3><p>
Subsystems can define their own policies to be placed in a group
whose name has this form. Their values are treated as lists,
in which items can have their meaning negated by prepending !
to the value. They are not otherwise parsed by Flatpak.
Available since 0.6.13.
</p></div></div><div class="refsect1"><a id="idm140021655815744"></a><h2>Example</h2><pre class="programlisting">
[Application]
name=org.gnome.Calculator
runtime=org.gnome.Platform/x86_64/3.20
sdk=org.gnome.Sdk/x86_64/3.20
command=gnome-calculator
[Context]
shared=network;ipc;
sockets=x11;wayland;
filesystems=xdg-run/dconf;~/.config/dconf:ro;
[Session Bus Policy]
ca.desrt.dconf=talk
[Environment]
DCONF_USER_CONFIG_DIR=.config/dconf
[Extension org.gnome.Calculator.Locale]
directory=share/runtime/locale
subdirectories=true
[Extension org.gnome.Calculator.Debug]
directory=lib/debug
</pre></div><div class="refsect1"><a id="idm140021655814160"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak"><span class="citerefentry"><span class="refentrytitle">flatpak</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-run"><span class="citerefentry"><span class="refentrytitle">flatpak-run</span>(1)</span></a>,
<a class="citerefentry" href="#flatpak-override"><span class="citerefentry"><span class="refentrytitle">flatpak-override</span>(1)</span></a>
</p></div></div><div class="refentry"><div class="refentry.separator"><hr /></div><a id="flatpak-remote"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>flatpak-remote — Configuration for a remote</p></div><div class="refsect1"><a id="idm140021659644576"></a><h2>Description</h2><p>
Flatpak stores information about configured remotes for an installation location in
<code class="filename">$installation/repo/config</code>. For example, the remotes for the
default system-wide installation are in
<code class="filename">$prefix/var/lib/flatpak/repo/config</code>, and the remotes for the
per-user installation are in <code class="filename">$HOME/.local/share/flatpak/repo/config</code>.
</p><p>
Normally, it is not necessary to edit remote config files directly, the
flatpak remote-modify command should be used to change properties of remotes.
</p><p>
System-wide remotes can be statically preconfigured by dropping
config fragments into <code class="filename">/etc/flatpak/remotes.d/</code>.
</p></div><div class="refsect1"><a id="idm140021660511248"></a><h2>File format</h2><p>
The remote config file format is using the same .ini file format that is used for systemd
unit files or application .desktop files.
</p><div class="refsect2"><a id="idm140021658888240"></a><h3>[remote …]</h3><p>
All the configuration for the the remote with name NAME is contained in the
[remote "NAME"] group.
</p><p>
The following keys are recognized by OSTree, among others:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">url</code> (string)</span></dt><dd><p>The url for the remote.</p></dd><dt><span class="term"><code class="option">gpg-verify</code> (boolean)</span></dt><dd><p>Whether to use GPG verification for content from this remote.</p></dd><dt><span class="term"><code class="option">gpg-verify-summary</code> (boolean)</span></dt><dd><p>Whether to use GPG verification for the summary of this remote.</p></dd></dl></div><p>
All flatpak-specific keys have a xa. prefix:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="option">xa.disable</code> (boolean)</span></dt><dd><p>Whether the remote is disabled. Defaults to false.</p></dd><dt><span class="term"><code class="option">xa.prio</code> (integer)</span></dt><dd><p>The priority for the remote. This is used when listing remotes. Defaults to 1.</p></dd><dt><span class="term"><code class="option">xa.noenumerate</code> (boolean)</span></dt><dd><p>Whether this remote should be used when presenting available contents. Defaults to true.</p></dd><dt><span class="term"><code class="option">xa.nodeps</code> (boolean)</span></dt><dd><p>Whether this remote should be used when searching for dependencies. Defaults to true.</p></dd><dt><span class="term"><code class="option">xa.title</code> (string)</span></dt><dd><p>An optional title to use when presenting this remote in a UI.</p></dd><dt><span class="term"><code class="option">xa.title-is-set</code> (boolean)</span></dt><dd><p>This key is set to true if <code class="option">xa.title</code> has been explicitly set.</p></dd><dt><span class="term"><code class="option">xa.default-branch</code> (string)</span></dt><dd><p>The default branch to use when installing from this remote.</p></dd><dt><span class="term"><code class="option">xa.default-branch-is-set</code> (boolean)</span></dt><dd><p>This key is set to true if <code class="option">xa.default-branch</code> has been explicitly set.</p></dd><dt><span class="term"><code class="option">xa.main-ref</code> (string)</span></dt><dd><p>The main reference served by this remote. This is used for origin remotes of applications installed via a flatpakref file.</p></dd><dt><span class="term"><code class="option">xa.oci</code> (boolean)</span></dt><dd><p>Whether this is an OCI remote. Defaults to false.</p></dd></dl></div></div></div><div class="refsect1"><a id="idm140021657038848"></a><h2>Examples</h2><pre class="programlisting">
[remote "gnome-nightly-apps"]
gpg-verify=true
gpg-verify-summary=true
url=https://sdk.gnome.org/nightly/repo-apps/
xa.title=GNOME Applications
</pre></div><div class="refsect1"><a id="idm140021655306016"></a><h2>See also</h2><p>
<a class="citerefentry" href="#flatpak-remote-modify"><span class="citerefentry"><span class="refentrytitle">flatpak-remote-modify</span>(1)</span></a>
</p></div></div></div></div></body></html>
|
