# trueapps

**Repository Path**: qwerty0007/trueapps

## Basic Information

- **Project Name**: trueapps
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-03
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# trueapps

## 介绍

truenas docker app yamls

## how to install

1. 修改仓库的 yaml,.env 和 .env.global 文件，以符合自己的实际配置。
2. 在自定义应用程序那里选择通过 YAML 进行安装
3. 给 app 一个名字
   将下面的 yaml 文本修改为自己的路径保存安装

```yaml
include:
  - env_file:
      - PATH-TO-YOUR-OWN/.env.global
      - PATH-TO-YOUR-OWN/.env
    path: PATH-TO-YOUR-OWN/docker-compose.yaml
#增加web port按钮，如果不需要，就删除，注意只是第一次安装有效，安装以后再加下面的内容不会生效
x-portals:
  - host: YOUR-HOST-IP
    name: Web UI
    path: /
    port: 80
    scheme: http
#增加注释， 按需配置，支持 makrdown 格式，注意只是第一次安装有效，安装以后再加下面的内容不会生效
x-notes: ‘

  #owncloud

  The new and most secure version of ownCloud real-time content collaboration platform.

  ’

```

> 参考
>
> - [在 TrueNAS 上运行 Docker 应用的更佳方案](https://www.bilibili.com/video/BV115tSzPEFU/?share_source=copy_web&vd_source=5158532412bafce97b73614e5a9f994c)
> - [官方文档](https://apps.truenas.com/managing-apps/installing-custom-apps/#installing-via-yaml)
> - [官方论坛](https://forums.truenas.com/t/electric-eel-how-i-am-using-dockerfile-env-files-compose-files/15252)

## 自定义安装的 app 配置 icon

自定义安装好 app 后，到 shell 里执行以后命令添加 icon 配置

```shell
icon_url=https://media.sys.truenas.net/apps/metube/icons/icon.svg
app=metube
app_pool=/mnt/.ix-apps
sed -i "/^[[:space:]]*\"metadata\":/a \  \"icon\": \"${icon_url}\"" ${app_pool}/app_configs/${app}/metadata.yaml
```

## todo

### 计划添加的 app list

- [x] lucky
- [x] vlmcsd