diff --git a/charts/incubator/archivebox/docs/installation_guide.md b/charts/incubator/archivebox/docs/installation_guide.md new file mode 100644 index 00000000000..3f262e0ca1f --- /dev/null +++ b/charts/incubator/archivebox/docs/installation_guide.md @@ -0,0 +1,59 @@ +--- +title: Installation Guide +--- + +## SCALE App +1. to setup archivebox: + +- `App Configuration > Admin Username & Admin Password` + Configure an initial admin username and password you want to log in with in the Web UI (only applied on first setup run). + Screenshot of example Admin Username & Password configuration + +- `Networking and Services > Service's Port(s) Configuration > Port` + Configure the port you want to access the ArchiveBox web interface on, or use the pre-populated default. + Screenshot of example Archivebox webserver port configuration + + +- `Storage and Persistence > App Data Storage` + Setup persistent a persistent storage volume to use for your ArchiveBox `/data` directory. + We recommend using a `Host Path` with `Automatic Permissions Configuration` disabled. + Screenshot of example App Data Storage configuration + Make sure whatever filesystem the data is located on supports FSYNC and doesn't squash permissions. + (NFS servers may need to set no_root_squash + no_all_squash) + For more info about ArchiveBox's filesystem requirements, see here: + - [ArchiveBox Filesystem Requirements](https://github.com/ArchiveBox/ArchiveBox#storage-requirements) + - [ArchiveBox Troubleshooting: Filesystems, NFS, FSYNC](https://github.com/ArchiveBox/ArchiveBox/wiki/Upgrading-or-Merging-Archives#filesystem-doesnt-support-fsync-eg-network-mounts) + - [ArchiveBox Issue #742](https://github.com/ArchiveBox/ArchiveBox/issues/742) (example of common filesystem issue with NFS) + + +- `Containers > Main Container > Extra Environment Variables` **(optional)** + Optionally add any other [ArchiveBox Configuration](https://github.com/ArchiveBox/ArchiveBox/wiki/Configuration) variables you want here. + Screenshot of example Archivebox extra configuration + + +2. ✅ Then **click `Install`** at the bottom, and wait a few minutes for it to finish deploying. + +3. Once deployed, **click `Applications > ArchiveBox > Web Portal` to access ArchiveBox** . + Screenshot TrueNAS Apps UI to access Web Portal + Screenshot ArchiveBox UI open in browser + Click the `Log In` (upper right) and proceed with the admin username and password you configured above. + Screenshot of ArchiveBox UI login page + Optionally change your password from the initial value by going to `Account` in the navbar (`/admin/password_change/`). + Screenshot of ArchiveBox navbar highlighting Account and Add buttons + Click `Add` in the menubar to get started adding new URLs to archive. + +--- + +## Further Reading + +- [ArchiveBox Documentation](https://github.com/ArchiveBox/ArchiveBox/wiki/) +- [ArchiveBox UI Usage](https://github.com/ArchiveBox/ArchiveBox/wiki/Usage#ui-usage) +- [ArchiveBox Security Overview](https://github.com/ArchiveBox/ArchiveBox/wiki/Security-Overview) +- [ArchiveBox Configuration](https://github.com/ArchiveBox/ArchiveBox/wiki/Configuration) +- [ArchiveBox Hosting Guide](https://github.com/ArchiveBox/ArchiveBox/wiki/Publishing-Your-Archive) +- [ArchiveBox Changelog](https://github.com/ArchiveBox/ArchiveBox/releases) + +### Ask For Help + +- [Archivebox Bug Tracker](https://github.com/ArchiveBox/ArchiveBox/issues) +- [ArchiveBox Community Forum / Chat Server](https://zulip.archivebox.io) diff --git a/charts/incubator/archivebox/questions.yaml b/charts/incubator/archivebox/questions.yaml index d044a59c25d..ce08a75d908 100644 --- a/charts/incubator/archivebox/questions.yaml +++ b/charts/incubator/archivebox/questions.yaml @@ -101,7 +101,6 @@ questions: type: int default: 568 # Include{resources} -# Include{postgresql} # Include{advanced} # Include{addons} # Include{codeserver} diff --git a/charts/incubator/archivebox/values.yaml b/charts/incubator/archivebox/values.yaml index 0987f8c24e0..f515a98f626 100644 --- a/charts/incubator/archivebox/values.yaml +++ b/charts/incubator/archivebox/values.yaml @@ -10,6 +10,7 @@ config: securityContext: container: readOnlyRootFilesystem: false + runAsNonRoot: false runAsGroup: 0 runAsUser: 0 @@ -18,6 +19,7 @@ service: ports: main: port: 9598 + protocol: http targetPort: 8000 workload: @@ -25,6 +27,10 @@ workload: podSpec: containers: main: + probes: + liveness: + type: http + path: /health/ env: ADMIN_USERNAME: "{{ .Values.config.admin_username }}" ADMIN_PASSWORD: "{{ .Values.config.admin_password }}"