{"id":24844244,"url":"https://github.com/carlosvelezr/cloud-personal","last_synced_at":"2026-05-19T04:04:28.343Z","repository":{"id":255687615,"uuid":"850909921","full_name":"CarlosVelezR/Cloud-Personal","owner":"CarlosVelezR","description":"Cloud project with its own on-site hardware resources. It is ideal for personal use, mainly storing files and photos, with backup in S3 type service.","archived":false,"fork":false,"pushed_at":"2025-01-30T03:06:27.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T07:43:45.068Z","etag":null,"topics":["cloud","immich","nextcloud"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/CarlosVelezR.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}},"created_at":"2024-09-02T04:17:59.000Z","updated_at":"2025-01-30T03:06:31.000Z","dependencies_parsed_at":"2024-09-13T01:08:43.566Z","dependency_job_id":"afc3ce45-e0d6-4226-846b-88eeb0bdbf95","html_url":"https://github.com/CarlosVelezR/Cloud-Personal","commit_stats":null,"previous_names":["carlosvelezr/desktop-tutorial","carlosvelezr/cloud-personal"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosVelezR%2FCloud-Personal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosVelezR%2FCloud-Personal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosVelezR%2FCloud-Personal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarlosVelezR%2FCloud-Personal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CarlosVelezR","download_url":"https://codeload.github.com/CarlosVelezR/Cloud-Personal/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245614994,"owners_count":20644376,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cloud","immich","nextcloud"],"created_at":"2025-01-31T09:17:06.504Z","updated_at":"2026-05-19T04:04:23.290Z","avatar_url":"https://github.com/CarlosVelezR.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cloud-Personal Docker Setup\n\nThis repository contains scripts and Docker configuration files to set up your own personal cloud storage solution using **Cloud-Personal**. The project includes Docker configuration, as well as Bash scripts to automate the deployment and management of the cloud service on your server.\n\n---\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Prerequisites](#prerequisites)\n- [Setup Instructions](#setup-instructions)\n  - [1. Clone the Repository](#1-clone-the-repository)\n  - [2. Build the Docker Containers](#2-build-the-docker-containers)\n  - [3. Configure the Database](#3-configure-the-database)\n  - [4. Start Cloud-Personal](#4-start-Cloud-Personal)\n  - [5. Access Cloud-Personal Web Interface](#5-access-Cloud-Personal-web-interface)\n- [Usage](#usage)\n- [Customization](#customization)\n- [Troubleshooting](#troubleshooting)\n- [License](#license)\n\n---\n\n## Introduction\n\nThis project is designed to make it easy for you to deploy **Cloud-Personal** in a containerized environment using Docker and Docker Compose. With this setup, you can create your own private cloud storage solution to store and manage your files securely.\n\nThe setup includes:\n\n- **NextCloud**: The main cloud storage platform.\n- **Immich**: A relational database to store Cloud-Personal data.\n- **Docker**: Containerization to simplify deployment and scaling.\n- **Bash scripts**: Automation scripts to easily set up, configure, and manage the environment.\n\n---\n\n## Prerequisites\n\nBefore getting started, make sure you have the following tools installed on your server or local machine:\n\n- **Docker**: Follow [Docker installation guide](https://docs.docker.com/get-docker/) for your platform.\n- **Docker Compose**: Follow [Docker Compose installation guide](https://docs.docker.com/compose/install/).\n- **Bash**: The scripts are designed for Linux or macOS environments with Bash. For Windows, consider using Windows Subsystem for Linux (WSL).\n\n---\n\n## Setup Instructions\n\nFollow these steps to get your Cloud-Personal up and running.\n\n### 1. Clone the Repository\n\nStart by cloning the repository to your local machine or server:\n\n```bash\ngit clone https://github.com/CarlosVelezR/Cloud-Personal.git\ncd Cloud-Personal-docker-setup\n```\n### 3. Create the folders - Replace path with yourUser.\n```\nmkdir /var/www/html\nmkdir /home/yourUser/immich\ncd /home/yourUser/immich\nmkdir /home/yourUser/immich/data\nmkdir /home/yourUser/sh\n```\n\n### 2. Build the Docker Containers\n\nTo build and set up the Docker containers, run the following command:\n\n```bash\ndocker-compose build\n```\n\nThis will pull the necessary images and build the Docker containers.\n\n\n### 4. Start Cloud-Personal\n\nOnce the database is configured, you can start Cloud-Personal by running the following command:\n\n```bash\ndocker-compose up -d\n```\n\nThis will start the containers in the background, including the web server and the database.\n\n### 5. Access Cloud-Personal Web Interface\n\nOnce the containers are up and running, you can access your Cloud-Personal instance through your web browser:\n\n```\nhttp://localhost:2283\n```\n\nThe first time you access the web interface, you will be prompted to complete the installation process by entering the database details and admin credentials.\n\n---\n\n## Usage\n\nOnce Cloud-Personal is up and running, you can use the web interface to upload and manage your files. You can also access your files using the **Cloud-Personal Desktop** or **Mobile** apps, available on their respective stores.\n\nYou can use the following URLs for some common actions:\n\n- **Web Interface**: `http://localhost:8080`\n- **Login page**: `http://localhost:8080/login`\n\n## BackUp\n\nTo backup your data install Borg in your Linux Server.\n\n```\napt install borgbackup\n```\nConfig your repository\n\n```\nUPLOAD_LOCATION=\"/home/drsean/immich/data\"\nBACKUP_PATH=\"/home/drsean/immich/data/backups\"\nmkdir \"$BACKUP_PATH\"\nmkdir \"$UPLOAD_LOCATION/database-backup\"\nborg init --encryption=none \"$BACKUP_PATH\"\n```\n\n\nExecute backupimmich.sh to generate a backup.\n\n```\nsh /home/drsean/immich/sh/backupimmich.sh \u0026\n```\n\n## How to Restore a Backup?\n\nExecute RestoreBackUp.sh\n\n```\nsh /home/drsean/immich/sh/RestoreBackUp.sh \u0026\n\n```\n---\n\n## Customization\n\nYou can customize the configuration by editing the `docker-compose.yml` and the `config/config.php` files. Some key options to consider:\n\n- **Ports**: You can change the exposed ports in `docker-compose.yml`.\n- **Database**: If you want to use an external database or change database settings, modify `docker-compose.yml` and the `setup_database.sh` script accordingly.\n- **Cloud-Personal Settings**: For advanced Cloud-Personal configuration, refer to the [official Cloud-Personal documentation](https://doc.Cloud-Personal.com/).\n\n---\n\n## Troubleshooting\n\nHere are some common issues and solutions:\n\n1. **Container not starting**:  \n   If containers fail to start, check the logs to debug the issue:\n   ```bash\n   docker-compose logs\n   ```\n   Look for any error messages related to database connectivity or missing environment variables.\n\n2. **Database connection issues**:  \n   If Cloud-Personal cannot connect to the MariaDB database, ensure that the database container is up and running. You can check the status with:\n   ```bash\n   docker-compose ps\n   ```\n\n3. **Permissions issues**:  \n   Make sure that the directories used by Cloud-Personal have the correct permissions. You can adjust this using the following command:\n   ```bash\n   sudo chown -R www-data:www-data ./data ./config ./apps\n   ```\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Acknowledgements\n\n- **Cloud-Personal**: [https://Cloud-Personal.com/](https://Cloud-Personal.com/)\n- **Docker**: [https://www.docker.com/](https://www.docker.com/)\n- **MariaDB**: [https://mariadb.org/](https://mariadb.org/)\n\n---\n\nIf you have any questions or issues, feel free to open an issue or submit a pull request!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlosvelezr%2Fcloud-personal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarlosvelezr%2Fcloud-personal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlosvelezr%2Fcloud-personal/lists"}