Nextcloud
A file sharing server that puts the control and security of your own data back into your hands.
- 1Copy the script below
- 2In HexOS, open Apps, find Nextcloud and choose Custom Install
- 3Paste, then press Install — full guide with screenshots
1{
12 "version": 5,
23 "script": {
4 "version": "0.1.0",
5 "changeLog": "Auto-generated draft from TrueNAS nextcloud 1.1.12"
6 },
37 "installation_questions": [
8 {
9 "question": "Admin user",
10 "type": "text",
11 "key": "admin_user",
12 "required": true
13 },
14 {
15 "question": "Admin password",
16 "type": "password",
17 "key": "admin_password",
18 "required": true
19 },
20 {
21 "question": "Host",
22 "type": "text",
23 "key": "host",
24 "required": true
25 }
26 ],
27 "requirements": {
428 "locations": ["ApplicationsPerformance"],
529 "specifications": ["2CORE"],
630 "permissions": ["READ_WRITE_LOCATIONS"],
731 "ports": [30125, 30493]
32 },
833 "ensure_directories_exists": [
34 {"path": "$LOCATION(ApplicationsPerformance)"},
35 {"path": "$LOCATION(ApplicationsPerformance)/nextcloud-community"},
36 {
37 "path": "$LOCATION(ApplicationsPerformance)/nextcloud-community/html",
38 "owner": {"user": "apps"},
39 "snapshot": {"id": "html"}
40 },
41 {
42 "path": "$LOCATION(ApplicationsPerformance)/nextcloud-community/data",
43 "owner": {"user": "apps"},
44 "snapshot": {"id": "data"}
45 },
46 {
47 "path": "$LOCATION(ApplicationsPerformance)/nextcloud-community/talk_recording_data",
48 "owner": {"user": "apps"},
49 "snapshot": {"id": "talk_recording_data"}
50 },
51 {
52 "path": "$LOCATION(ApplicationsPerformance)/nextcloud-community/postgres_data",
53 "owner": {"user": "netdata", "group": "docker"},
54 "snapshot": {"id": "postgres_data"}
55 }
56 ],
57 "app_values": {
58 "nextcloud": {
959 "admin_user": "$QUESTION(admin_user)",
1060 "admin_password": "$QUESTION(admin_password)",
1161 "redis_password": "$RANDOM_STRING(16)",
1262 "db_password": "$RANDOM_STRING(16)",
1363 "urls": {"host": "$QUESTION(host)"}
64 },
65 "storage": {
1466 "html": "$HOST_PATH($LOCATION(ApplicationsPerformance)/nextcloud-community/html)",
1567 "data": "$HOST_PATH($LOCATION(ApplicationsPerformance)/nextcloud-community/data)",
1668 "talk_recording_data": "$HOST_PATH($LOCATION(ApplicationsPerformance)/nextcloud-community/talk_recording_data)",
1769 "postgres_data": "$HOST_PATH($LOCATION(ApplicationsPerformance)/nextcloud-community/postgres_data)"
70 },
71 "network": {
1872 "web_port": {"bind_mode": "published", "port_number": 30125},
1973 "talk_port": {"bind_mode": "published", "port_number": 30493}
74 },
2075 "resources": {"limits": {"cpus": 2, "memory": "$MEMORY(10%, 4096)"}}
76 }
77}
What this script does
Hover or tap a box to see the lines it explains.
-
Script format
Tells HexOS this is a version 5 install script, so it knows how to read the rest.
Line 2
-
Script revision
This copy of the script is revision 0.1.0. Latest change: “Auto-generated draft from TrueNAS nextcloud 1.1.12”.
Lines 3–6
-
Questions you'll be asked
Before installing, HexOS will ask you for: Admin user, Admin password and Host. Your answers are slotted into the settings further down wherever you see $QUESTION(...).
Lines 7–26
-
Storage locations it needs
The app uses these HexOS storage locations: App storage (fast). If one isn't set up yet, HexOS will ask you to pick a place for it.
Line 28
-
Minimum hardware
Recommended minimum: 2 CPU cores.
Line 29
-
Permission to use your folders
Allows the app to read and write files inside the storage locations listed above — and nowhere else.
Line 30
-
Network ports
The app needs ports 30125 and 30493 to be free on your server. A port is like an apartment number for your server's address.
Line 31
-
Folders created on install
Creates the folders the app needs before it starts: App storage (fast) › nextcloud-community, App storage (fast) › nextcloud-community › html, App storage (fast) › nextcloud-community › data, App storage (fast) › nextcloud-community › talk_recording_data and App storage (fast) › nextcloud-community › postgres_data. Some folders are handed to a specific system user so the app is allowed to write to them. Folders marked “snapshot” are included in HexOS snapshots, so you can roll them back.
Lines 33–56
-
Your answer: admin user
Filled in with what you typed for “admin user” when you installed.
Line 59
-
Your answer: admin password
Filled in with what you typed for “admin password” when you installed.
Line 60
-
Auto-generated redis password
HexOS makes up a long random redis password during install. It's only used inside Nextcloud, so you never need to know it.
Line 61
-
Auto-generated db password
HexOS makes up a long random db password during install. It's only used inside Nextcloud, so you never need to know it.
Line 62
-
Your answer: host
Filled in with what you typed for “host” when you installed.
Line 63
-
Where the app's “html” files is saved
Where the app's “html” files is saved on your server: App storage (fast) › nextcloud-community › html.
Line 66
-
Where the app's main data is saved
Where the app's main data is saved on your server: App storage (fast) › nextcloud-community › data.
Line 67
-
Where the app's “talk recording data” files is saved
Where the app's “talk recording data” files is saved on your server: App storage (fast) › nextcloud-community › talk_recording_data.
Line 68
-
Where the app's database is saved
Where the app's database is saved on your server: App storage (fast) › nextcloud-community › postgres_data.
Line 69
-
Web port: 30125
The app's web page is published on port 30125. You don't need to remember it — clicking the app's card in HexOS takes you there.
Line 72
-
Talk port: 30493
Publishes the app's talk port as 30493.
Line 73
-
Resource limits
Caps how much of your server the app can use: 2 CPU cores and 10% of your server's memory, but never more than 4 GB. This keeps one busy app from slowing everything else down.
Line 75