{"id":26265956,"url":"https://github.com/eden-box/documentation","last_synced_at":"2026-02-01T01:33:06.023Z","repository":{"id":218609474,"uuid":"204672462","full_name":"eden-box/documentation","owner":"eden-box","description":"📘 Eden Box documentation","archived":false,"fork":false,"pushed_at":"2020-03-01T20:34:45.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-14T09:43:14.356Z","etag":null,"topics":["documentation","eden-box","manual"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eden-box.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-27T09:50:30.000Z","updated_at":"2019-08-27T11:30:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"5f93f4bf-4bbb-4a2a-ab2d-a6e6cf2c83d3","html_url":"https://github.com/eden-box/documentation","commit_stats":null,"previous_names":["eden-box/documentation"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/eden-box/documentation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eden-box%2Fdocumentation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eden-box%2Fdocumentation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eden-box%2Fdocumentation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eden-box%2Fdocumentation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eden-box","download_url":"https://codeload.github.com/eden-box/documentation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eden-box%2Fdocumentation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28963913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T01:25:30.373Z","status":"ssl_error","status_checked_at":"2026-02-01T01:25:29.809Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["documentation","eden-box","manual"],"created_at":"2025-03-14T03:16:08.903Z","updated_at":"2026-02-01T01:33:06.014Z","avatar_url":"https://github.com/eden-box.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Eden Box Documentation\n\n## Description\nThese documents summarize all knowledge needed in order to redeploy and maintain the existing Eden Box project components, while requiring only basic Linux and sysadmin knowledge, easily acquirable online.\n\n## Outline\nThe project relies upon two Ubuntu virtual machines, both provided by [Okeanos-Global](./services/okeanos.md).\nBoth machines automatically update daily at 2 a.m WEST, using unattended-upgrades utility.\nAdditionally, the machines create a snapshot of their current state twice a month (1st and 15th) and upload it to the Okeanos [Pithos](./services/okeanos.md#pithos) service, in order to provide recoverability means in case of severe failure of the VMs.\nGiven that Pithos' capacity is limited, these snapshots overwrite older ones so that, at a given time, only 4 distinct snapshots of a machine are stored in the cloud.\n\nThe machine with the role of file server, designated from here on as _eden-fs_, provides:\n- Nextcloud service, responsible for providing the file storage platform;\n- Public interface to Nextcloud;\n- Python log reader, responsible for detecting file access entries written to the Nextcloud log and sending them to the database.\n\nThe machine with the role of database, designated from here on as _eden-db_, provides:\n- PostgreSQL database, responsible for saving timestamps of each file access on the server side\n\u003c!--* TODO add Data Science capabilities information --\u003e\n\nFor more information about the machines, please refer to [machines](./service/machines.md) section.\n\nEach of the admin members can access the machines through ssh authentication, solemnly to their own user.\nThe required RSA keys are ad-hoc distributed to each of the users.\nNote that the key used to authenticate a user is the same on both machines, which allows easier configuration at the expense of a more resilient security solution.\nThe safest option would require a key pair per-user for each machine, although less pratical to manage.\n\n## Deployment\nMore information is available on the [deployment](./deployment/) section. \n\n## Maintenance\nEven though many maintenance steps have been suppressed through automation, there are still some tasks that require administrative attention and support. \nPlease refer to the [maintenance](./maintenance/) section for more information.\n\n## Security Concerns\nUp to the available knowledge at the time of deployment, the best practices and concerns related to Cyber-security have been attended. However, the system's resilience to miscreants still relies on the most vulnerable link: its users. Therefore, extreme care is advised to admin users whilst handling private keys and database user certificates, as those possessing them are implicitly provided access to machines and are therefore able to undermine the system at will. Hence, under any circumstance should they grant access to third parties whose trust is not assured.\n\n## License\nAll documentation in this repository is licensed under the Creative Commons Attribution 4.0 International license ([CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)).\n\n## Acknowledgments\nAll collaboration and commitment of those involved in this project is truly cherished and appreciated.\n\n_\"It must be considered that there is nothing more difficult to carry out nor more doubtful of success nor more dangerous to handle than to initiate a new order of things.\"_ - Machiavelli\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feden-box%2Fdocumentation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feden-box%2Fdocumentation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feden-box%2Fdocumentation/lists"}