A continuation of HomeBox the inventory and organization system built for the Home User
[VNEXT] feat: Opt-In Anlytics (#277)
Matt Kilgorede4a3ef7a9cf
diff --git a/backend/app/api/main.go b/backend/app/api/main.goindex dce3ed01..bc16d508 100644--- a/backend/app/api/main.go+++ b/backend/app/api/main.go@@ -3,8 +3,10 @@ package mainimport ("bytes""context"+ "encoding/json""fmt""github.com/google/uuid"+ "github.com/shirou/gopsutil/v4/host""net/http""os""path/filepath"@@ -89,6 +91,52 @@ func run(cfg *config.Config) error {app := new(cfg)app.setupLogger()+ if cfg.Options.AllowAnalytics {+ type analyticsData struct {+ Domain string `json:"domain"`+ Name string `json:"name"`+ URL string `json:"url"`+ Props map[string]interface{} `json:"props"`+ }+ hostData, _ := host.Info()+ analytics := analyticsData{+ Domain: "homebox.software",+ URL: "https://homebox.software/stats",+ Name: "stats",+ Props: map[string]interface{}{+ "version": version + "/" + build(),+ "os": hostData.OS,+ "platform": hostData.Platform,+ "platform_family": hostData.PlatformFamily,+ "platform_version": hostData.PlatformVersion,+ "kernel_arch": hostData.KernelArch,+ "virt_type": hostData.VirtualizationSystem,+ },+ }+ jsonBody, err := json.Marshal(analytics)+ if err != nil {+ log.Error().Err(err).Msg("failed to marshal analytics data")+ }+ bodyReader := bytes.NewReader(jsonBody)+ req, err := http.NewRequest("POST", "https://a.sysadmins.zone/api/event", bodyReader)+ if err != nil {+ log.Error().Err(err).Msg("failed to create analytics request")+ }+ req.Header.Set("Content-Type", "application/json")+ req.Header.Set("User-Agent", "Homebox/"+version+"/"+build()+" (https://homebox.software)")+ client := &http.Client{+ Timeout: 10 * time.Second,+ }+ res, err := client.Do(req)+ if err != nil {+ log.Error().Err(err).Msg("failed to send analytics request")+ }+ err = res.Body.Close()+ if err != nil {+ log.Error().Err(err).Msg("failed to send analytics request")+ }+ }+// =========================================================================// Initialize Database & Reposdiff --git a/backend/go.mod b/backend/go.modindex 0dfafbe7..d0a071e3 100644--- a/backend/go.mod+++ b/backend/go.mod@@ -18,6 +18,7 @@ require (github.com/olahol/melody v1.2.1github.com/pkg/errors v0.9.1github.com/rs/zerolog v1.33.0+ github.com/shirou/gopsutil/v4 v4.24.9github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686egithub.com/stretchr/testify v1.10.0github.com/swaggo/http-swagger/v2 v2.0.2@@ -28,7 +29,16 @@ require (modernc.org/sqlite v1.36.0)-require github.com/zclconf/go-cty-yaml v1.1.0 // indirect+require (+ github.com/ebitengine/purego v0.8.0 // indirect+ github.com/go-ole/go-ole v1.2.6 // indirect+ github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0 // indirect+ github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c // indirect+ github.com/tklauser/go-sysconf v0.3.12 // indirect+ github.com/tklauser/numcpus v0.6.1 // indirect+ github.com/yusufpapurcu/wmi v1.2.4 // indirect+ github.com/zclconf/go-cty-yaml v1.1.0 // indirect+)require (github.com/KyleBanks/depth v1.2.1 // indirectdiff --git a/backend/go.sum b/backend/go.sumindex c6008725..53ec7832 100644--- a/backend/go.sum+++ b/backend/go.sum@@ -21,6 +21,8 @@ github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97cgithub.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=+github.com/ebitengine/purego v0.8.0 h1:JbqvnEzRvPpxhCJzJJ2y0RbiZ8nyjccVUrSM3q+GvvE=+github.com/ebitengine/purego v0.8.0/go.mod h1:iIjxzd6CiRiOG0UyXP+V1+jWqUXVjPKLAI0mRfJZTmQ=github.com/fatih/color v1.18.0 h1:S8gINlzdQ840/4pfAwic/ZE0djQEH3wM94VfqLTZcOM=github.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=github.com/fogleman/gg v1.3.0 h1:/7zJX8F6AaYQc57WQCyN9cAIz+4bCJGO9B+dyW29am8=@@ -31,6 +33,8 @@ github.com/go-chi/chi/v5 v5.2.1 h1:KOIHODQj58PmL80G2Eak4WdvUzjSJSm0vG72crDCqb8=github.com/go-chi/chi/v5 v5.2.1/go.mod h1:L2yAIGWB3H+phAw1NxKwWM+7eUH/lU8pOMm5hHcoops=github.com/go-logr/logr v1.2.3 h1:2DntVwHkVopvECVRSlL5PSo9eG+cAkDCuckLubN+rq0=github.com/go-logr/logr v1.2.3/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=+github.com/go-ole/go-ole v1.2.6 h1:/Fpf6oFPoeFik9ty7siob0G6Ke8QvQEuVcuChpwXzpY=+github.com/go-ole/go-ole v1.2.6/go.mod h1:pprOEPIfldk/42T2oK7lQ4v4JSDwmV0As9GaiUsvbm0=github.com/go-openapi/inflect v0.21.0 h1:FoBjBTQEcbg2cJUWX6uwL9OyIW8eqc9k4KhN4lfbeYk=github.com/go-openapi/inflect v0.21.0/go.mod h1:INezMuUu7SJQc2AyR3WO0DqqYUJSj8Kb4hBd7WtjlAw=github.com/go-openapi/jsonpointer v0.21.0 h1:YgdVicSA9vH5RiHs9TZW5oyafXZFc6+2Vc1rr/O9oNQ=@@ -60,6 +64,7 @@ github.com/golang/freetype v0.0.0-20170609003504-e2365dfdc4a0 h1:DACJavvAHhabrF0github.com/golang/freetype v0.0.0-20170609003504-e2365dfdc4a0/go.mod h1:E/TSTwGwJL78qG/PmXZO1EjYhfJinVAhrmmHX6Z8B9k=github.com/golang/protobuf v1.5.3 h1:KhyjKVUg7Usr/dYsdSqoFveMYd5ko72D+zANwlG1mmg=github.com/golang/protobuf v1.5.3/go.mod h1:XVQd3VNwM+JqD3oG2Ue2ip4fOMUkwXdXDdiuN0vRsmY=+github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=github.com/google/pprof v0.0.0-20240409012703-83162a5b38cd h1:gbpYu9NMq8jhDVbvlGkMFWCjLFlqqEZjEmObmhUy6Vo=@@ -86,6 +91,8 @@ github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=github.com/lib/pq v1.10.9 h1:YXG7RB+JIjhP29X+OtkiDnYaXQwpS4JEWq7dtCCRUEw=github.com/lib/pq v1.10.9/go.mod h1:AlVN5x4E4T544tWzH6hKfbfQvm3HdbOxrmggDNAPY9o=+github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0 h1:6E+4a0GO5zZEnZ81pIr0yLvtUWk2if982qA3F3QD6H4=+github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0/go.mod h1:zJYVVT2jmtg6P3p1VtQj7WsuWi/y4VnjVBn7F8KPB3I=github.com/mailru/easyjson v0.9.0 h1:PrnmzHw7262yW8sTBwxi1PdJA3Iw/EKBa8psRf7d9a4=github.com/mailru/easyjson v0.9.0/go.mod h1:1+xMtQp2MRNVL/V1bOzuP3aP8VNwRW55fQUto+XFtTU=github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=@@ -111,6 +118,8 @@ github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=+github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c h1:ncq/mPwQF4JjgDlrVEn3C11VoGHZN7m8qihwgMEtzYw=+github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c/go.mod h1:OmDBASR4679mdNQnz2pUhc2G8CO2JrUAVFDRBDP/hJE=github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE=github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo=github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M=@@ -118,6 +127,8 @@ github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzgithub.com/rs/xid v1.5.0/go.mod h1:trrq9SKmegXys3aeAKXMUTdJsYXVwGY3RLcfgqegfbg=github.com/rs/zerolog v1.33.0 h1:1cU2KZkvPxNyfgEmhHAz/1A9Bz+llsdYzklWFzgp0r8=github.com/rs/zerolog v1.33.0/go.mod h1:/7mN4D5sKwJLZQ2b/znpjC3/GQWY/xaDXUM0kKWRHss=+github.com/shirou/gopsutil/v4 v4.24.9 h1:KIV+/HaHD5ka5f570RZq+2SaeFsb/pq+fp2DGNWYoOI=+github.com/shirou/gopsutil/v4 v4.24.9/go.mod h1:3fkaHNeYsUFCGZ8+9vZVWtbyM1k2eRnlL+bWO8Bxa/Q=github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686e h1:MRM5ITcdelLK2j1vwZ3Je0FKVCfqOLp5zO6trqMLYs0=github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686e/go.mod h1:XV66xRDqSt+GTGFMVlhk3ULuV0y9ZmzeVGR4mloJI3M=github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=@@ -128,12 +139,18 @@ github.com/swaggo/http-swagger/v2 v2.0.2 h1:FKCdLsl+sFCx60KFsyM0rDarwiUSZ8DqbfSygithub.com/swaggo/http-swagger/v2 v2.0.2/go.mod h1:r7/GBkAWIfK6E/OLnE8fXnviHiDeAHmgIyooa4xm3AQ=github.com/swaggo/swag v1.16.4 h1:clWJtd9LStiG3VeijiCfOVODP6VpHtKdQy9ELFG3s1A=github.com/swaggo/swag v1.16.4/go.mod h1:VBsHJRsDvfYvqoiMKnsdwhNV9LEMHgEDZcyVYX0sxPg=+github.com/tklauser/go-sysconf v0.3.12 h1:0QaGUFOdQaIVdPgfITYzaTegZvdCjmYO52cSFAEVmqU=+github.com/tklauser/go-sysconf v0.3.12/go.mod h1:Ho14jnntGE1fpdOqQEEaiKRpvIavV0hSfmBq8nJbHYI=+github.com/tklauser/numcpus v0.6.1 h1:ng9scYS7az0Bk4OZLvrNXNSAO2Pxr1XXRAPyjhIx+Fk=+github.com/tklauser/numcpus v0.6.1/go.mod h1:1XfjsgE2zo8GVw7POkMbHENHzVg3GzmoZ9fESEdAacY=github.com/yeqown/go-qrcode/v2 v2.2.5 h1:HCOe2bSjkhZyYoyyNaXNzh4DJZll6inVJQQw+8228Zk=github.com/yeqown/go-qrcode/v2 v2.2.5/go.mod h1:uHpt9CM0V1HeXLz+Wg5MN50/sI/fQhfkZlOM+cOTHxw=github.com/yeqown/go-qrcode/writer/standard v1.2.5 h1:m+5BUIcbsaG2md76FIqI/oZULrAju8tsk47eOohovQ0=github.com/yeqown/go-qrcode/writer/standard v1.2.5/go.mod h1:O4MbzsotGCvy8upYPCR91j81dr5XLT7heuljcNXW+oQ=github.com/yeqown/reedsolomon v1.0.0 h1:x1h/Ej/uJnNu8jaX7GLHBWmZKCAWjEJTetkqaabr4B0=github.com/yeqown/reedsolomon v1.0.0/go.mod h1:P76zpcn2TCuL0ul1Fso373qHRc69LKwAw/Iy6g1WiiM=+github.com/yusufpapurcu/wmi v1.2.4 h1:zFUKzehAFReQwLys1b/iSMl+JQGSCSjtVqQn9bBrPo0=+github.com/yusufpapurcu/wmi v1.2.4/go.mod h1:SBZ9tNy3G9/m5Oi98Zks0QjeHVDvuK0qfxQmPyzfmi0=github.com/zclconf/go-cty v1.16.0 h1:xPKEhst+BW5D0wxebMZkxgapvOE/dw7bFTlgSc9nD6w=github.com/zclconf/go-cty v1.16.0/go.mod h1:VvMs5i0vgZdhYawQNq5kePSpLAoz8u1xvZgrPIxfnZE=github.com/zclconf/go-cty-debug v0.0.0-20240509010212-0d6042c53940 h1:4r45xpDWB6ZMSMNJFMOjqrGHynW3DIBuR2H9j0ug+Mo=@@ -152,8 +169,12 @@ golang.org/x/net v0.36.0 h1:vWF2fRbw4qslQsQzgFqZff+BItCvGFQqKzKIzx1rmoA=golang.org/x/net v0.36.0/go.mod h1:bFmbeoIPfrw4sMHNhb4J9f6+tPziuGjq7Jk/38fxi1I=golang.org/x/sync v0.11.0 h1:GGz8+XQP4FvTTrjZPzNKTMFtSXH80RAzG+5ghFPgK9w=golang.org/x/sync v0.11.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=+golang.org/x/sys v0.0.0-20190916202348-b4ddaad3f8a3/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=+golang.org/x/sys v0.0.0-20201204225414-ed752295db88/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=+golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=+golang.org/x/sys v0.11.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc=golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=@@ -161,6 +182,7 @@ golang.org/x/text v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM=golang.org/x/text v0.22.0/go.mod h1:YRoo4H8PVmsu+E3Ou7cqLVH8oXWIHVoX0jqUWALQhfY=golang.org/x/tools v0.30.0 h1:BgcpHewrV5AUp2G9MebG4XPFI1E2W41zU1SaqVA9vJY=golang.org/x/tools v0.30.0/go.mod h1:c347cR/OJfw5TI+GfX7RUPNMdDRRbjvYTS0jPyvsVtY=+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=google.golang.org/protobuf v1.28.1 h1:d0NfwRgPtno5B1Wa6L2DAG+KivqkdutMf1UhdNx175w=google.golang.org/protobuf v1.28.1/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=diff --git a/backend/internal/sys/config/conf.go b/backend/internal/sys/config/conf.goindex b861f7df..64ea0e09 100644--- a/backend/internal/sys/config/conf.go+++ b/backend/internal/sys/config/conf.go@@ -35,6 +35,7 @@ type Options struct {AutoIncrementAssetID bool `yaml:"auto_increment_asset_id" conf:"default:true"`CurrencyConfig string `yaml:"currencies"`GithubReleaseCheck bool `yaml:"check_github_release" conf:"default:true"`+ AllowAnalytics bool `yaml:"allow_analytics" conf:"default:false"`}type DebugConf struct {diff --git a/docs/.vitepress/menus/en.mts b/docs/.vitepress/menus/en.mtsindex c47f55ad..e42aaf11 100644--- a/docs/.vitepress/menus/en.mts+++ b/docs/.vitepress/menus/en.mts@@ -27,5 +27,12 @@ export default [{text: 'Get Started', link: '/en/contribute/get-started'},{text: 'Bounty Program', link: '/en/contribute/bounty'}]+ },+ {+ text: 'Analytics',+ items: [+ {text: 'Purpose & Data', link: '/en/analytics'},+ {text: 'Privacy Policy', link: '/en/analytics/privacy'},+ ]}]\ No newline at end of filediff --git a/docs/en/analytics/index.md b/docs/en/analytics/index.mdnew file mode 100644index 00000000..dd37c595--- /dev/null+++ b/docs/en/analytics/index.md@@ -0,0 +1,14 @@+---+aside: false+---++## What is This?+We collect non-identifying information from users of Homebox that have opted in to analytics collection. By default users do not send us anything, however once opted in that data gets sent to our own Plausibe instance and the data below is live from that instance.++We make this data public so that everyone knows exactly what's being collected, and so that they can see the data we see as it helps us make some decisions.++## Current Analytics Collected++<iframe plausible-embed src="https://a.sysadmins.zone/share/homebox.software?auth=O2nQ-b8I0oo80RKJXx2Q7&embed=true&theme=system&goal=stats" scrolling="no" frameborder="0" loading="lazy" style="width: 1px; min-width: 100%; height: 100%; min-height: 1600px"></iframe>+<div style="font-size: 14px; padding-bottom: 14px;">Stats powered by <a target="_blank" style="color: #4F46E5; text-decoration: underline;" href="https://plausible.io">Plausible Analytics</a> hosted on our own instance in the UK</div>+<script async src="https://a.sysadmins.zone/js/embed.host.js"></script>\ No newline at end of filediff --git a/docs/en/analytics/privacy.md b/docs/en/analytics/privacy.mdnew file mode 100644index 00000000..adbaec5d--- /dev/null+++ b/docs/en/analytics/privacy.md@@ -0,0 +1,68 @@+---+aside: false+---++# Homebox Privacy Policy++## Introduction++**Homebox** (and by extension; Sysadmins Media) respects the privacy of its users and is committed to protecting the data shared through our application. This privacy policy outlines the types of data collected from users who opt in to analytics, the purposes for which we collect and use this data, how it is stored, and the rights of our users under UK and US law. By opting in to data collection, you agree to the practices described in this policy.++# 1. Data Collected++With the user's consent (opt-in analytics only), Homebox collects **anonymized** data, including:++* Homebox application version+* Operating System (OS) type and platform family+* Platform version+* Kernel architecture+* Virtualization system used+* General location data (country or region), as provided by our analytics tool, **Plausible**++Additionally, we collect default, anonymized data through Plausible, such as usage statistics, to understand how Homebox is used and to support its ongoing development.++# 2. Data Storage and Control++All data collected through Homebox's analytics are managed and stored in our self-hosted Plausible instance. No user data resides on third-party servers or is shared outside the control of Homebox and its administrative team (Sysadmins Media). The anonymized analytics generated from this data are publicly accessible, allowing users to review the data as we do, however Homebox will at no point share (or store) any analytical data that can be used to personally identify individual users of its systems.++# 3. Data Usage++We use the collected data exclusively to improve Homebox:++* Informing development focus based on popular platforms, architectures, and virtualization systems+* Aiding in troubleshooting and diagnostic processes for better support and stability++All data collected is aggregated and anonymized to ensure individual users cannot be identified.++# 4. Data Retention++The information remains in our self-hosted Plausible instance as long as it remains useful for improving the application, there is no set retention period for the deletion of this data, however Homebox remains dedicated to transparency and openly shares the anonymized usage data collected by our systems publicly for our users to review.++# 5. User rights and Opt-In Consent++As Homebox is operated around the world, we conform to the relevant laws as applicable in any local jurisdiction. Homebox data is stored and processed in the US, with staff residing in US and UK locations.++Under both UK and US data protection laws, users have the following rights:++* **Right to opt-in**: Data collection only begins when a user explicitly chooses to share this information.+* **Right to review**: Users can view the publicly accessible analytics to understand how their data contributes to Homebox.+* **Right to withdraw consent**: Users may opt out at any time, stopping any further data collection from their device.++# 6. 3rd Parties++Homebox may use 3rd parties as part of providing the web services to operate. Currently this includes only Cloudflare, who handles cyber security services to our analytics endpoints and websites. You can view their privacy policy at https://www.cloudflare.com/privacypolicy/++# 7. Policy Changes++Any changes to this privacy policy will be communicated to users through Homebox's update channels (namely Discord or Reddit) **at a minimum** 7 full days prior to any change being conducted (unless mandated by law to do so otherwise).++Continued use of Homebox following updates will imply acceptance of the revised policy, and users are free to opt-out of analytics at any point without impact to their usage of Homebox software.+++### Contact Us++For any questions about this privacy policy or your data, please contact the team through our official channels:++* Discord: https://discord.homebox.software/+* Reddit Modmail: r/Homebox+* Github: https://git.homebox.software/diff --git a/docs/en/configure.md b/docs/en/configure.mdindex 5019f112..5554667b 100644--- a/docs/en/configure.md+++ b/docs/en/configure.md@@ -15,6 +15,7 @@ aside: false| HBOX_OPTIONS_ALLOW_REGISTRATION | true | allow users to register themselves || HBOX_OPTIONS_AUTO_INCREMENT_ASSET_ID | true | auto-increments the asset_id field for new items || HBOX_OPTIONS_CURRENCY_CONFIG | | json configuration file containing additional currencie |+| HBOX_OPTIONS_ALLOW_ANALYTICS | false | Allows the homebox team to view extremely basic information about the system that your running on. This helps make decisions regarding builds and other general decisions. || HBOX_WEB_MAX_UPLOAD | 10 | maximum file upload size supported in MB || HBOX_WEB_READ_TIMEOUT | 10s | Read timeout of HTTP sever || HBOX_WEB_WRITE_TIMEOUT | 10s | Write timeout of HTTP server |@@ -98,6 +99,7 @@ OPTIONS--options-auto-increment-asset-id/$HBOX_OPTIONS_AUTO_INCREMENT_ASSET_ID <bool> (default: true)--options-currency-config/$HBOX_OPTIONS_CURRENCY_CONFIG <string>--options-check-github-release/$HBOX_OPTIONS_CHECK_GITHUB_RELEASE <bool> (default: true)+--options-allow-analytics/$HBOX_OPTIONS_ALLOW_ANALYTICS <bool> (default: false)--label-maker-width/$HBOX_LABEL_MAKER_WIDTH <int> (default: 526)--label-maker-height/$HBOX_LABEL_MAKER_HEIGHT <int> (default: 200)--label-maker-padding/$HBOX_LABEL_MAKER_PADDING <int> (default: 32)diff --git a/docs/en/installation.md b/docs/en/installation.mdindex 1e3a2ff3..9c5ad2ef 100644--- a/docs/en/installation.md+++ b/docs/en/installation.md@@ -32,6 +32,7 @@ $ docker run -d \--restart unless-stopped \--publish 3100:7745 \--env TZ=Europe/Bucharest \+ --env HBOX_OPTIONS_ALLOW_ANALYTICS=false \--volume /path/to/data/folder/:/data \ghcr.io/sysadminsmedia/homebox:latest# ghcr.io/sysadminsmedia/homebox:latest-rootless@@ -52,6 +53,8 @@ services:- HBOX_LOG_LEVEL=info- HBOX_LOG_FORMAT=text- HBOX_WEB_MAX_FILE_UPLOAD=10+ # Please consider allowing analytics to help us improve Homebox (basic computer information, no personal data)+ - HBOX_OPTIONS_ALLOW_ANALYTICS=falsevolumes:- homebox-data:/data/ports: